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1 2  Contents 


About  this  guide 


This  reference  guide  provides  information  to  help  you: 


Understand  and  use  Fabric  OS  commands 


Manage  a  switch  or  fabric 


Intended  audience 


This  guide  is  intended  for: 

This  book  is  intended  for  use  by  administrators  who  are  experienced  with  the  following: 

•  HP  StorageWorks  Fibre  Channel  SAN  switches 

•  Fabric  Operating  System  4.x  or  later 


Related  documentation 


Documentation,  including  white  papers  and  best  practices  documents,  is  available  via  the  HP  website. 
Please  go  to: 


To  access  4.x  related  documents: 

1 .  Locate  the  Networked  storage  section  of  the  web  page. 

2.  Under  Networked  storage,  go  to  the  By  type  subsection. 

3.  Click  SAN  infrastructure.  The  SAN  infrastructure  page  displays. 

4.  Locate  the  Fibre  Channel  Switches  section. 

Locate  the  B-Series  Fabric  subsection,  then  go  to  the  appropriate  subsection,  such  as  Enterprise  Class 

for  the  SAN  Director  2/128. 

To  access  version  4.x  documents  (such  as  this  document),  select  the  appropriate  product,  for  example 
SAN  Director  2/1 28  &  SAN  Director  2/1 28  power  pack  or  Core  Switch  2/64  &  Core  Switch  2/64 
power  pack. 

The  switch  overview  page  displays. 

5.  Go  to  the  Product  Information  section,  located  on  the  far  right  side  of  the  web  page. 

6.  Click  Technical  documents. 

7.  Follow  the  onscreen  instructions  to  download  the  applicable  documents. 
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Document  conventions  and  symbols 

Table  1    Document  conventions 


Convention 

Element 

Medium  blue  text:  Figure  1 

Cross-reference  links  and  e-mail  addresses 

Medium  blue,  underlined  text 
(http://www.hp.com) 

Web  site  addresses 

Bold  font 

•  Key  names 

•  Text  typed  into  a  GUI  element,  such  as  into  a  box 

•  GUI  elements  that  are  clicked  or  selected,  such  as  menu  and  list 
items,  buttons,  and  check  boxes 

Italics  font 

Text  emphasis 

Monospace  font 

•  File  and  directory  names 

•  System  output 

•  Text  typed  at  the  command  line 

Monospace,    italic  font 

Nonvariable  text  values  (numbers)  typed  at  the  command  line 

Monospace,  bold  font 

Emphasis  of  file  and  directory  names,  system  output,  code,  and  text 
typed  at  the  command-line 

WARNING!    Indicates  that  failure  to  follov/  directions  could  result  in  bodily  harm  or  death. 


CAUTION:    Indicates  that  failure  to  follow  directions  could  result  in  damage  to  equipment  or  data. 


\\~}^  IMPORTANT:    Provides  clarifying  information  or  specific  instructions. 


NOTE:    Provides  additional  information. 


2q1  TIP:    Provides  helpful  hints  and  shortcuts. 
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HP  technical  support 


Telephone  numbers  for  worldwide  technical  support  are  listed  on  the  HP  web  site: 
http:/  /  www.hp.com/ support/. 


NOTE:    For  continuous  quality  improvement,  calls  may  be  recorded  or  monitored. 


Collect  the  following  information  before  calling: 

•  Technical  support  registration  number  (if  applicable) 

•  Product  serial  numbers 

•  Product  model  names  and  numbers 

•  Applicable  error  messages 

•  Operating  system  type  and  revision  level 

•  Detailed,  specific  questions 


The  HP  web  site  provides  the  latest  information  on  this  product,  as  well  as  the  latest  drivers.  Access  storage 

at:  http:/ / www.hp.com/ country/ us/ eng/ prodserv/ storage.html.  From  this  web  site,  select  the  appropriate 
product  or  solution. 


HP-authorized  reseller 

For  the  name  of  your  nearest  HP-authorized  reseller: 
•    In  the  United  States,  call  1  ■800-345-1 518. 


Elsewhere,  visit  http://www.hp.com  and  click  Contact  HP  to  find  locations  and  telephone  numbers. 


HP  Storage  web  site 
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About  this  guide 


1    Fabric  OS  command  line  interface 


This  chapter  explains  the  different  methods  used  to  manage  HP  SAN  and  HP  StorageWorks  switches.  The 
following  information  is  discussed: 

•  Changes  to  this  guide  for  OS  v5.0.0,  page  1 7 

•  Using  the  Fabric  OS  command  line  interface,  page  20 

•  Using  this  guide,  page  20 


Changes  to  this  guide  for  OS  vS.O.O 

The  following  changes  are  new  to  v5.0.0  and  are  not  included  elsewhere  in  this  guide. 

This  section  explains  how  to  manage  HP  StorageWorks  SAN  switches  and  the  Brocade  4Gb  SAN  Switch 
for  HP  p-Class  BladeSystem.  The  following  information  is  discussed: 

•  Understanding  access  levels,  page  17 

•  Using  the  Fabric  OS  command  line  interface,  page  20 

Refer  to  HP  StorageWorks  Fabric  OS  5.0.0  features  overview  and  HP  StorageWorks  Fabric  OS  5.0.0 
procedures  user  guide  ior  information  regarding  optionally  licensed  features  and  information  regarding 
configuration  and  management  procedures,  respectively. 

Understanding  access  levels 

Fabric  OS  supports  two  classes  of  user  accounts:  default  account  and  multiple  user  account  (MUA). 

Default  accounts,  introduced  in  early  versions  of  Fabric  OS,  include  root,  factory,  admin,  and  user.  Each 
account  has  hard-coded  permissions  that  define  roles  whose  privileges  correspond  to  the  account  name. 
The  root  and  factory  levels  are  reserved  for  support  and  manufacturing  personnel.  The  admin  and  user 
levels  are  intended  for  general  switch  and  fabric  administration  activities.  The  admin  role  can  perform  all 
Fabric  OS  operations.  The  user  role  performs  observation-only  operations. 

The  MUAs  available  in  Fabric  OS  3.x  and  earlier  provide  only  limited  multiple  user  access  to  a  switch. 
Each  switch  enables  only  a  single  session  per  access  method,  regardless  of  the  user's  access  level. 
Switches  can,  however,  be  accessed  simultaneously  from  different  connections:  for  example,  through  the 
command  line  interface  (CLI)  and  Web  Tools.  If  this  happens,  changes  from  one  connection  might  not  be 
updated  to  the  other,  and  some  changes  might  be  lost.  When  you  connect  using  simultaneous  multiple 
connections,  make  sure  that  you  do  not  overwrite  the  work  of  another  connection. 

In  Fabric  OS  4.x,  multiple  sessions  are  allowed.  Each  access  level  can  have  the  number  of  simultaneous 
logins  shown  in  Table  4. 

Table  2    Fabric  OS  4.x  user  access  maximum  simultaneous  sessions 


User  name 

Maximum  number  of 
simultaneous  sessions 

admin 

2 

user 

4 

The  MUA  feature  distinguishes  between  a  user  account  and  the  role  assigned  to  the  account.  The 
switchAdmin  role,  introduced  in  Fabric  OS  5.0.0,  has  most  of  the  existing  admin  role  permissions  except 


Fabric  OS  5.0.0  command  reference  guide     1 7 


the  ability  to  perform  zone  and  security  configuration  and  user  management.  Refer  to  Table  3  for  a 
high-level  description  of  role  permissions. 

Table  3    Role  permissions 


Functional  area 

User 

switchAdmin 

admin 

Zone  configuration 

Viev\/ 

View 

Modify 

Environmental 

Viev/ 

Modify 

Modify 

Logs  (Remote  Access  Service  -  RAS) 

View 

Modify 

Modify 

Security 

Viev/ 

View 

Modify 

Sv/itch  configuration 

Viev/ 

Modify 

Modify 

Sv/itch  management 

Viev/ 

Modify 

Modify 

Port  configuration 

Viev/ 

Modify 

Modify 

SNMP 

View 

Modify 

Modify 

Diagnostics 

View 

Modify 

Modify 

Devices 

View 

Modify 

Modify 

User  management 

View 

n/a 

Modify 

Fabric  Watch 

View 

Modify 

Modify 

Advanced  Performance  Monitoring 

View 

Modify 

Modify 

Admin  domain  management 

View 

n/a 

Modify 

The  MUA  feature  was  introduced  in  Fabric  OS  3.2.0  and  4.4.0.  The  switchAdmin  role  can  log  in; 
however,  the  role  is  restricted  to  user-level,  observation-based  functions. 


NOTE:  The  admin  access  level  has  access  to  all  the  commands  needed  to  manage  and  configure  a 
switch  or  fabric.  The  admin  account  is  the  recommended  login  level. 


Using  the  Fabric  OS  command  line  interface 

The  Fabric  OS  command  line  interface  (accessed  through  either  telnet  or  serial  console)  provides  an 
administrator  with  full  management  capability  on  an  HP  StorageWorks  switch  or  a  Brocade  4Gb  SAN 
Switch  for  HP  p-Class  BladeSystem  switch.  The  Fabric  OS  CLI  enables  an  administrator  to  monitor  and 
manage  entire  fabrics,  individual  switches,  and  ports  from  a  standard  workstation.  The  entire  suite  of 
Fabric  OS  features  and  capabilities  is  available  across  an  entire  fabric,  from  a  single  access  point. 
Selected  commands  must  be  issued  from  a  sectelnet  or  SSH  session,  as  indicated  in  the  command 
description  in  this  guide. 

Access  to  the  CLI  is  controlled  by  a  switch-level  password  for  each  access  level.  The  commands  available 
through  the  CLI  are  based  on  the  user's  login  level  or  role  and  the  license  keys  used  to  unlock  certain 
features. 

Fabric  OS  CLI  is  the  complete  fabric  management  tool  for  HP  StorageWorks  SAN  switches  and  a 
Brocade  4Gb  SAN  Switch  for  HP  p-Class  BladeSystem,  providing: 

•  access  to  the  full  range  of  Fabric  OS  features,  based  on  which  license  keys  you  purchase. 

•  assistance  with  configuration,  monitoring,  dynamic  provisioning,  and  daily  management  of  every 
aspect  of  storage  area  networks. 

•  a  deeper  view  of  the  tasks  involved  in  managing  an  HP  StorageWorks  switch  or  director. 

•  configuration  and  management  of  the  HP  StorageWorks  fabric  on  multiple  levels. 
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•  identification,  isolation,  and  management  of  SAN  events  across  every  sv/itchi  in  the  fabric. 

•  management  sv/itch  licenses. 

Tfie  rest  of  this  guide  describes  each  CLI  command,  including  a  synopsis  of  its  syntax,  the  users  to  v/hom 
it  is  available,  and  a  description  of  command  use  and  behavior.  The  same  information  is  available  to  you 
on  your  HP  StorageWorks  switch  or  director  or  Brocade  4Gb  SAN  Sv/itch  for  HP  p-Class  BladeSystem, 
using  the  help  command.  For  example,  to  display  the  help  or  man  page  for  aliAdd,  enter: 

switch : admin>  help  aliadd 

Fabric  OS  5.0.0  supports  the  follov/ing  nev/  commands: 

•  enclosureShow 

•  fabricLog 

•  fabStateResize 

•  fcPing 

Use  the  help  command  to  display  detailed  information  for  these  commands. 


Understanding  access  levels 

There  are  four  levels  of  access  for  a  StorageWorks  switch  or  director: 

•  root 

•  factory 

•  admin 

•  user 

Not  all  commands  are  available  to  all  access  levels.  Root  level  has  access  to  all  commands.  However, 
use  root  and  factory  levels  with  caution,  as  these  levels  are  reserved  for  support  and  manufacturing 
personnel.  The  user  level  has  limited  access  to  commands.  This  manual  lists  all  the  commands  available  to 
the  user-  and  admin-level  logins. 


NOTE:  The  admin  access  level  has  access  to  all  the  commands  needed  to  manage  and  configure  a 
switch  or  fabric.  The  admin  account  is  the  recommended  login  level. 


In  HP  Fabric  OS  v3.x  and  earlier,  multiple-user  access  to  a  switch  is  limited.  Each  switch  enables  only  a 
single  session  per  access  method,  regardless  of  the  user's  access  level.  Switches  can,  however,  be 
accessed  simultaneously  from  different  connections:  for  example,  through  the  CLI  and  HP  Advanced  Web 
Tools.  If  this  happens,  changes  from  one  connection  might  not  be  updated  to  the  other,  and  some 
changes  might  be  lost.  When  you  connect  using  simultaneous  multiple  connections,  ensure  that  you  do 
not  overwrite  the  work  of  another  connection. 
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In  Fabric  OS  v4.x,  multiple  sessions  are  allowed.  Each  access  level  can  have  the  number  of  simultaneous 
logins  shov/n  in  Table  4. 


Table  4    Fabric  OS  v4.x  user  access  maximum  sessions 


User  name 

Maximum  number 

of  simultaneous  sessions 

root 

4 

factory 

4 

admin 

2 

user 

4 

Using  the  Fabric  OS  command  line  interface 

The  Fabric  OS  command  line  interface  (CLI),  accessed  through  either  telnet  or  serial  console,  provides  an 
administrator  v/ith  full  management  capability  on  a  StorageWorks  sv/itch.  The  Fabric  OS  CLI  enables  an 
administrator  to  monitor  and  manage  entire  fabrics,  individual  svvitches,  and  ports  from  a  standard 
workstation.  The  entire  suite  of  Fabric  OS  features  and  capabilities  is  available  across  an  entire  fabric, 
from  a  single  access  point.  Selected  commands  must  be  issued  from  a  sectelnet  or  SSH  session,  as 
indicated  in  the  command  description  in  this  manual. 

Access  is  controlled  by  a  switch-level  password  for  each  access  level  (factory,  root,  admin,  and  user).  The 
commands  available  through  the  CLI  are  based  on  the  user's  login  level  and  the  license  keys  used  to 
unlock  certain  features. 

Fabric  OS  CLI  is  the  complete  fabric  management  tool  for  HP  SANs  and  provides  the  following: 

•  Access  to  the  full  range  of  Fabric  OS  features,  based  on  which  license  keys  you  purchase 

•  Assistance  with  configuration,  monitoring,  dynamic  provisioning,  and  daily  management  of  every 
aspect  of  storage  area  networks 

•  A  deeper  view  of  the  tasks  involved  in  managing  a  StorageWorks  switch  or  director 

•  Configuration  and  management  of  the  HP  fabric  on  multiple  levels 

•  Identification,  isolation,  and  management  of  SAN  events  across  every  switch  in  the  fabric 

•  Management  switch  licenses 


Using  this  guide 

This  guide  describes  each  command,  including  a  synopsis  of  its  syntax,  the  users  to  which  it  is  available, 
and  a  description  of  command  usage  and  behavior.  The  same  information  is  available  to  you  on  your 
StorageWorks  switch  or  director,  using  the  help  command.  For  example,  to  display  the  help  or  man 
page  for  aliAdd,  type: 

switch : admin>  help  aliadd 
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2    Fabric  OS  commands 


This  chapter  lists  the  Fabric  OS  commands.  It  also  shows  their  syntax  and  operands,  and  provides 
examples  of  their  usage. 


Fabric  OS  5.0.0  command  reference  guide  21 


aaaConfig 

Manages  RADIUS  configuration  information. 

Synopsis 

aaaconfig   [action]  [options] 

Availability 

admin 


Description 

Use  this  command  to  manage  the  RADIUS  configuration  for  the  authentication,  authorization,  and 
accounting  (AAA)  services.  This  command  displays,  adds,  removes,  changes,  enables,  or  disables 
RADIUS  configuration. 

When  the  command  completes,  any  new  configuration  is  saved  persistently.  It  is  effective  for  the  next  AAA 
request.  The  configuration  applies  to  all  sv/itch  instances  in  a  platform  supporting  multiple  sv/itch  domains. 

Use  the  centralized  RADIUS  servers  to  manage  AAA  services  for  a  sv/itch,  as  defined  in  RFC  2865. 


[i2^  NOTE:    This  command  can  be  executed  v/hen  logged  in  through  serial  or  SSH  connection. 


Operands 


The  command  takes  as  input  an  action  and  its  associated  options.  Without  any  specified  action,  the 
command  displays  the  usage.  Specify  action  as  one  of  following: 


-show 

-add  server  [options] 
-remove  server 
-change  server  [options] 
-move  server  to _j}Osition 


-radius   [on   |  off] 
-switchdb   [on   I  off] 


Displays  the  current  AAA  service  configuration. 

Adds  a  RADIUS  server  to  the  configuration. 

Removes  a  RADIUS  server  from  the  configuration. 

Changes  a  RADIUS  server  configuration. 

Moves  a  RADIUS  server  from  the  current  position  to  a  new 
position.  When  server  is  a  required  operand  for  an  action,  it 
must  be  either  an  IP  address  or  a  name  in  dot  notation.  If  a 
name  is  used,  DNS  must  be  properly  configured. 

Turns  on  or  off  the  current  RADIUS  configuration. 

Turns  on  or  off  the  switch  local  database  as  secondary 
authentication. 


The  following  are  the  options  for  the  --add  and  --change  actions: 


-p  port 

-s  secret 

-t  timeout 

-a   [pap   I  chap] 


RADIUS  server  port  number 

Common  secret  between  the  switch  and  RADIUS  server 
Response  timeout  for  the  RADIUS  server 
Use  PAP  or  CHAP  as  authentication  protocol 


The  following  provides  a  detailed  description  of  each  action  type: 
--show 


List  the  current  RADIUS  servers,  along  with  their 
parameters. 
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■-add  server  [-p  port]    [-s  secret]    [-t  timeout]    [-a  cliap   |  pap] 

Add  the  specified  server  to  the  end  of  the  RADIUS 
configuration  list,  with  the  specified  port  number,  shared 
secret,  timeout,  and  if  PAP  or  CHAP  is  to  be  used  as 
authentication  protocol,  server  must  be  different  from  the 
servers  in  the  existing  configuration. 

--remove  server  Remove  the  specified  server  from  the  RADIUS 

configuration  list.server  must  match  a  server  in  the  existing 
configuration.  To  remove  the  last  server,  you  must  disable 
the  RADIUS  configuration  first. 

--cliange  server  [-p  port]    [-s  secret]    [-t  timeout]    [-a  cliap   |  pap] 

Change  parameters  for  the  specified  server  in  the  existing 
RADIUS  configuration  list,  server  must  match  one  in  the 
existing  configuration. 

--move  server  to_position         Move  the  specified  server  in  the  existing  RADIUS 

configuration  list  from  the  current  position  to  the  specified 
nev/  position.  This  rearranges  the  order  in  v/hich  the 
specified  RADIUS  server  is  used. 

Enable  or  disable  the  current  RADIUS  configuration  for 
AAA  services.  This  is  used  to  switch  the  primary  AAA 
services  between  RADIUS  and  the  switch  local  database. 
To  enable  the  RADIUS  configuration,  there  must  be  at  least 
one  server  existing  in  the  configuration. 

Enable  or  disable  the  switch  local  database  as  the 
secondary  AAA  services.  When  enabled,  if  RADIUS 
requests  a  timeout  for  all  RADIUS  servers,  the  switch  local 
database  is  used  for  authentication;  otherwise,  requests 
are  denied. 


--radius    [on   I  off] 


■-switchdb   [on   I  off] 


Examples 


To  display  the  current  RADIUS  configuration: 


switch ; adinin>  aaaconfig  --show 

Position  Server 

Port 

Secret    Timeout (s) 

Auth- Protocol 

1  192.168.233.48 

1812 

sharedsecret  3 

CHAP 

2  192.168.233.44 

1812 

sharedsecret  3 

CHAP 

3  radserver 

1812 

private  5 

CHAP 

Primary  AAA  Service: 

Switch 

database 

Secondary  AAA  Service:  None 

To  change  the  configuration  for  server  1 92. 1 68.233.48: 


switch : admin>  aaaconfig  --change  192.158.233.48  -p  3002  -s  newsecret  -t  1 


See  also 


none 
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agtCfg  Default 


Resets  the  SNMP  agent  configuration  to  default  values. 


Synopsis 

agtcfgde fault 

Availability 

admin 

Description 

Use  this  command  to  reset  the  SNMP  agent  configuration  to  default  values. 

This  command  prompts  the  user  and  only  proceeds  to  reset  on  the  user's  confirmation.  All  nev/  values 
successfully  configured  by  the  command  take  effect  immediately.  These  changes  are  persistent  across 
pov/er  cycles  and  reboots.  For  dual-domain  systems,  agtCf  gDef  ault  operates  on  the  SNMP  agent 
associated  v/ith  the  current  sv/itch. 


NOTE:  On  the  Core  Switch  2/64,  there  is  one  SNMP  agent  per  logical  sv/itch.  This  command  is  specific 
to  the  logical  sv/itch  you  are  logged  in  to. 


This  command  resets  the  follov/ing  values: 


sysDescr 

sysLocation 

sysContact 

authTraps 


The  system  description.  The  default  value  is  Fibre  Channel  Switch. 

The  location  of  the  system.  The  default  value  is  End  User  Premise. 

The  contact  information  for  the  system.  The  default  value  is  Field  Support.  Refer  to 
the  HP  StorageWorks  Fabric  OS  4.x  MIB  reference  guide  for  detailed  sysDescr, 
sysLocation,  and  sysContact  descriptions. 

When  enabled,  the  authentication  trap,  authenticationFailure,  is  transmitted  to  a 
configured  trap  recipient  in  the  event  the  agent  received  a  protocol  message  that 
is  not  properly  authenticated.  In  the  context  of  SNMPvl  and  SNMPv2c,  this 
means  that  a  request  contains  a  community  string  that  is  not  known  to  the  agent. 
The  default  value  for  this  parameter  is  0  (disabled). 

There  are  six  communities  and  respective  trap  recipients  supported  by  the  agent.  The  first  three 
communities  are  for  read-write  (rw)  access  and  the  last  three  are  for  read-only  (ro)  access.  The  default 
value  for  the  trap  recipient  of  each  community  is  0.0.0.0.  The  default  values  for  the  community  strings  are 
as  follows: 

Community  1 :  Secret  Code 

Community  2:  OrigEquipMfr 

Community  3:  private 

Community  4:  public 

Community  5:  common 

Community  6:  FibreChannel 

For  an  SNMP  management  station  to  receive  a  trap  generated  by  the  agent,  the  administrator  must 
configure  a  trap  recipient  to  correspond  to  the  IP  address  of  the  management  station.  In  addition,  the  trap 
recipient  must  be  able  to  pass  the  access  control  list  (ACL)  check. 
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Trap  recipient  severity  level 

The  trap  severity  level  is  associated  with  each  trap  recipient  IP  address.  The  event  trap  level  is  in 
conjunction  with  the  event's  severity  level.  When  an  event  occurs  and  if  its  severity  level  is  at  or  below  the 
set  value,  the  SNMP  event  traps  (swEventTrap,  swFabricWatchTrap,  and  connUnitEventTrap) 
are  sent  to  the  trap  recipients.  By  default,  this  value  is  set  to  0,  implying  that  no  such  traps  are  sent. 
Possible  values  are  as  follows: 


0 

none 

1 

critical 

2 

error 

3 

warning 

4 

informationa 

5 

debug 

Refer  to  errShow  for  related  information. 

The  ACL  check  is  as  follows:  there  are  six  ACLs  to  restrict  SNMP  get/set/trap  operations  to  hosts  under  a 
host-subnet-area.  Host-subnet-area  is  defined  by  comparing  nonzero  IP  octets.  For  example,  an  ACL  of 
192.168.64.0  enables  access  by  any  hosts  that  start  with  the  specified  octets.  The  connecting  host  is 
enabled  to  set  each  host-subnet-area  to  be  read-write  or  read-only.  The  highest  privilege  matched  out  of  six 
entries  is  given  to  the  access.  The  ACL  check  is  turned  off  when  all  six  entries  contain  0.0.0.0. 


§f  NOTE:   When  secure  mode  is  enabled,  the  access  control  list  feature  is  incorporated  into  the  WSNMP 
and  RSNMP  security  policies.  Community  strings  can  be  changed  on  the  primary  PCS  switch  only  and  will 
propagate  changes  across  the  fabric. 


Operands 

none 

Examples 

To  reset  the  SNMP  agent  to  default  values: 

switch : admin>  agtcf gdef ault 

•k  -k 

This  command  will  reset  the  agent's  configuration  back  to  factory 
default 

■k  ii  -k  -k  ~k 

Current  SNMP  Agent  Configuration 
Customizable  MIB-II  system  variables: 

sysDescr  =  Fibre  Channel  Switch. 
sysLocation  =  End  User  Premise 
sysContact  =  sweng 
authTraps  =  0  (OFF) 

(continued  on  next  page) 
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SNMPvl  community  and  trap  recipient  configuration: 
Community  1:   Secret  COde  (rw) 

Trap  recipient:  192.168.15.41 

Trap  recipient  Severity  level :  4 
Community  2:   OrigEquipMfr  (rw) 

No  trap  recipient  configured  yet 

Community  3 :  private  (rw) 

No  trap  recipient  configured  yet 
Community  4:  public  (ro) 

No  trap  recipient  configured  yet 
Community  5:   common  (ro) 

No  trap  recipient  configured  yet 
Community  6:   FibreChannel  (ro) 

No  trap  recipient  configured  yet 

SNMP  access  list  configuration: 

Entry  0:  Access  host  subnet  area  192.168.64.0    (rw)  ] 

Entry  1:  No  access  host  configured  yet 

Entry  2 :  No  access  host  configured  yet 

Entry  3 :  No  access  host  configured  yet 

Entry  4 :  No  access  host  configured  yet 

Entry  5:  No  access  host  configured  yet 

•k  k  -k  k 

Are  you  sure?    (yes,   y,   no,   n) :    [no]  y 
Committing  configuration ...  done . 
agent  configuration  reset  to  factory  default 
Current  SNMP  Agent  Configuration 
Customizable  MIB-II  system  variables: 

sysDescr  =  Fibre  Channel  Switch. 
sysLocation  =  End  User  Premise 
sysContact  =  Field  Support. 
authTraps  =  0  (OFF) 

(continued  on  next  page) 
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SNMPvJ 

cominuni  ty 

and  trap  recipient  configuration: 

Community 

1:   Secret  COde  (rw) 

No  trap 

recipient  configured 

yet 

Community 

2:   OrigEquipMfr  (rw) 

No  trap 

recipient  configured 

yet 

Community 

3 :  private   ( rw) 

No  trap 

recipient  configured 

yet 

Community 

4:  public  (ro) 

No  trap 

recipient  configured 

yet 

Community 

5:   common  (ro) 

No  trap 

recipient  configured 

yet 

Community 

6:   FibreChannel  (ro) 

No  trap 

recipient  configured 

yet 

SNMP  access  list 

configuration : 

Entry 

0 :     No  access  host  configured  yet 

Entry 

1:     No  access  host  configured  yet 

Entry 

2 :     No  access  host  configured  yet 

Entry 

3 :     No  access  host  configured  yet 

Entry 

4:     No  access  host  configured  yet 

Entry 

5 :     No  access  host  configured  yet 

See  also 

agtCf gSet 
agtCf gShow 
snmpConf ig 
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agtCfgSet 

Modifies  the  SNMP  agent  configuration. 

Synopsis 

agtcf gset 

Availability 

admin 

Description 

Use  this  command  to  modify  the  configuration  of  the  SNMP  agent  in  the  switch. 

All  values  successfully  configured  by  this  command  take  effect  immediately.  These  values  are  persistent 
across  pov/er  cycles  and  reboots.  For  dual-domain  systems,  this  command  operates  on  the  SNMP  agent 
associated  v/ith  the  current  switch. 

r2^Jf  NOTE:    On  the  Core  Switch  2/64,  there  is  one  SNMP  agent  per  logical  switch.  This  command  is  specific 
to  the  logical  switch  you  are  logged  in  to. 

This  command  updates  the  following  values: 

sysDescr  The  system  description.  The  default  value  is  Fibre  Channel  Switch. 

sysLocation  The  location  of  the  system.  The  default  value  is  End  User  Premise. 

sysContact  The  contact  information  for  the  system.  The  default  value  is  Field 

Support.  Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  MIB 
reference  gu/'c/e  for  detailed  sysDescr,  sysLocation,  and 
sysContact  descriptions. 

authTrapsEnabled  When  enabled,  the  authentication  trap,  authenticationFailure,  is 

transmitted  to  a  configured  trap  recipient  in  the  event  the  agent 
received  a  protocol  message  that  is  not  properly  authenticated.  In 
the  context  of  SNMPvl  and  SNMPv2c,  this  means  that  a  request 
contains  a  community  string  that  is  not  known  to  the  agent.  The 
default  value  for  this  parameter  is  0  (disabled). 

There  are  six  communities  and  respective  trap  recipients  supported  by  the  agent.  The  first  three 
communities  are  for  read-write  (rw)  access  and  the  last  three  are  for  read-only  (ro)  access.  The  default 
value  for  the  trap  recipient  of  each  community  is  0.0.0.0.  The  default  values  for  the  community  strings  are 
as  follows: 

Community  1 :  Secret  Code 

Community  2:  OrigEquipMfr 

Community  3:  private 

Community  4:  public 

Community  5:  common 

Community  6:  FibreChannel 

For  an  SNMP  management  station  to  receive  a  trap  generated  by  the  agent,  the  administrator  must 
configure  a  trap  recipient  to  correspond  to  the  IP  address  of  the  management  station.  In  addition,  the  trap 
recipient  must  be  able  to  pass  the  access  control  list  (ACL)  check. 
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Trap  recipient  severity  level 

The  trap  severity  level  is  associated  with  each  trap  recipient  IP  address.  The  event  trap  level  is  in 
conjunction  with  the  event's  severity  level.  When  an  event  occurs  and  if  its  severity  level  is  at  or  below  the 
set  value,  the  SNMP  event  traps  (swEventTrap,  swFabricWatchTrap,  and  connUnitEventTrap) 
are  sent  to  the  trap  recipients.  By  default,  this  value  is  set  to  0,  implying  that  no  such  traps  are  sent. 
Possible  values  are  as  follows: 


0 


none 


1 


critical 


2 


error 


3 
4 


warning 

informational 

debug 


5 


Refer  to  errShow  for  related  information. 

The  ACL  check  is  as  follows:  there  are  six  ACLs  to  restrict  SNMP  get/set/trap  operations  to  hosts  under  a 
host-subnet-area.  Host-subnet-area  is  defined  by  comparing  nonzero  IP  octets.  For  example,  an  ACL  of 
192.168.64.0  enables  access  by  any  hosts  that  start  with  the  specified  octets.  The  connecting  host  is 
enabled  to  set  each  host-subnet-area  to  be  read-write  or  read-only.  The  highest  privilege  matched  out  of  six 
entries  is  given  to  the  access.  The  ACL  check  is  turned  off  when  all  six  entries  contain  0.0.0.0. 


§f  NOTE:   When  secure  mode  is  enabled,  the  access  control  list  feature  is  incorporated  into  the  WSNMP 
and  RSNMP  security  policies.  Community  strings  can  be  changed  on  the  primary  PCS  switch  only  and  will 
propagate  changes  across  the  fabric. 


Operands 

none 

Examples 

To  modify  the  SNMP  configuration  values: 


switch :admin>  agtcfgset 


Customizing  MIB-II  system  variables 


At  each  prompt,   do  one  of  the  followings: 


o  <Return>  to  accept  current  value. 


o  enter  the  appropriate  new  value. 


o  <Control-D>  to  skip  the  rest  of  configuration,  or 


o  <Control-C>  to  cancel  any  change. 


(continued  on  next  page) 
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To  correct  any  input  mistake: 

<Backspace>  erases  the  previous  character, 
<Control-U>  erases  the  whole  line, 
sysDescr:    [FC  Switch] 
sysLocation:    [End  User  Premise] 
sysContact:    [Field  Support.] 
authTrapsEnabled  (true,   t,   false,   f ) :  [true] 
SNMP  community  and  trap  recipient  configuration: 
Community  (rw) :    [Secret  COde] 

Trap  Recipient's  IP  address  in  dot  notation:  [192.168.1.51] 
Trap  recipient  Severity  level   :    (0..5)    [0]  3 
Community   (rw) :    [OrigEquipMf r ] 

Trap  Recipient's  IP  address  in  dot  notation:  [192.168.1.26] 
Trap  recipient  Severity  level   :    (0..5)  [0] 
Community   (rw) :  [private] 

Trap  Recipient's  IP  address  in  dot  notation:    [0.0.0.0]  192.168.64.! 
Trap  recipient  Severity  level   :    (0..5)    [0]  1 
Community   (ro) :  [public] 

Trap  Recipient's  IP  address  in  dot  notation:  [0.0.0.0] 
Community   (ro) :  [common] 

Trap  Recipient's  IP  address  in  dot  notation:  [0.0.0.0] 
Community   (ro) :    [FibreChannel ] 


Trap  Recipient's  IP  address  in 

dot  notation: 

;  1 

[0. 

.  0  . 

SNMP  access  list 

configuration : 

Access  host 

subnet 

area  in  dot 

notation : 

[0. 

.0. 

.0. 

.0] 

Read/Write? 

(true. 

t,   false,  f) 

:  [true] 

Access  host 

subnet 

area  in  dot 

notation : 

[0. 

.0. 

.  0  . 

.0] 

Read/Write? 

( true , 

t,   false,  f) 

:  [true] 

Access  host 

subnet 

area  in  dot 

notation : 

[0. 

.0. 

.0. 

.0] 

Read/Write? 

(true. 

t,   false,  f) 

:  [true] 

Access  host 

subnet 

area  in  dot 

notation : 

[0. 

.0. 

.  0  . 

.0] 

Read/Write? 

( true , 

t,   false,  f) 

:  [true] 

Access  host 

subnet 

area  in  dot 

notation : 

[0. 

.0. 

.0. 

.0] 

Read/Write? 

(true. 

t,   false,  f) 

:  [true] 

Access  host 

subnet 

area  in  dot 

notation : 

[0. 

.0. 

.  0  . 

.0] 

Read/Write? 

( true , 

t,   false,  f) 

:  [true] 

Committing  configuration ...  done . 
value  =  1  =  0x1 


See  also 

agtCfgDefault 
agtCf  gSliow 
snmpConf ig 

SW_v5_x.mib,  Switch  Management  Information  &  Switch  Enterprise  Specific  Trap 
RFC!  157,  A  Simple  Network  Management  Protocol  (SNMPvl) 

RFC! 21 3,  Management  information  Base  for  Network  Management  of  TCP/IP-based  internets:  MIB-II 
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agtCfgShow 


Displays  the  SNMP  agent  configuration. 


Synopsis 

agtcf gshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  configuration  of  the  SNMP  agent  in  the  switch. 


NOTE:  On  a  dual-switch  chassis,  there  is  one  SNMP  agent  per  logical  switch.  This  command  is  specific 
b— I    to  the  logical  switch  you  are  logged  in  to. 


There  are  six  communities,  respective  trap  recipients,  and  trap  recipients  supported  by  the  agent.  The  first 
three  communities  are  for  read-write  (rw)  access  and  the  last  three  are  for  read-only  (ro)  access.  The 
default  value  for  the  trap  recipient  of  each  community  is  0.0.0.0.  The  community  string  length  ranges  from 
2  to  1 6  characters.  The  default  values  for  the  community  strings  are: 

•  Community  1:  Secret  COde 

•  Community  2:  OrigEquipMfr 

•  Community  3:  private 

•  Community  4:  public 

•  Community  5:  common 

•  Community  6:  FibreChannel 

For  an  SNMP  management  station  to  receive  a  trap  generated  by  the  agent,  the  administrator  must 
configure  a  trap  recipient  to  correspond  to  the  IP  address  of  the  management  station.  In  addition,  the  trap 
recipient  must  be  able  to  pass  the  access  control  list  (ACL)  check. 


The  following  information  displays: 


authTrapsEnabled 


sysDescr 


sysLocation 


sysContact 
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Trap  recipient  severity  level 

The  event  trap  level  in  conjunction  with  the  event's  severity  level.  When  an  event  occurs  and  if  its  severity 
level  is  at  or  below  the  set  value,  the  SNMP  trap,  swEventTrap,  is  sent  to  configured  trap  recipients.  By 
default,  this  value  is  set  to  0,  implying  that  no  swEventTrap  is  sent.  Possible  values  are: 


0 

none 

1 

critical 

2 

error 

3 

warning 

4 

informationa 

5 

debug 

Refer  to  errShow  for  related  information. 

The  ACL  check  is  as  follows:  there  are  six  ACLs  to  restrict  SNMP  get/set/trap  operations  to  hosts  under  a 
host-subnet-area.  Host-subnet-area  is  defined  by  comparing  nonzero  IP  octets.  For  example,  an  ACL  of 
1 92. 1 68.64.0  enables  access  by  any  hosts  that  start  with  the  specified  octets.  The  connecting  host  is 
enabled  to  set  each  host-subnet-area  to  be  read-write  or  read-only.  The  highest  privilege  matched  out  of  six 
entries  is  given  to  the  access.  The  ACL  check  is  turned  off  when  all  six  entries  contain  0.0.0.0. 


NOTE:    When  secure  mode  is  enabled,  the  access  control  list  feature  is  incorporated  into  the  WSNMP 
—i    and  RSNMP  security  policies.  Community  strings  can  be  changed  on  the  primary  PCS  switch  only  and  will 
propagate  changes  across  the  fabric. 


Operands 

none 

Examples 

switch : admin>  agtcfgshow 
Current  SNMP  Agent  Configuration 

Customizable  MIB-II  system  variables: 
sysDescr  =  FC  Switch 
sysLocation  =  End  User  Premise 
sysContact  =  Field  Support. 
authTraps  =  1  (ON) 
SNMPvl  community  and  trap  recipient  configuration: 
Community  1:   Secret  COde  (rw) 
Trap  recipient:  192.168.1.51 
Trap  recipient  Severity  level :  4 
Community  2:   OrigEquipMfr  (rw) 
Trap  recipient:  192.168.1.26 
Trap  recipient  Severity  level:  0 
Community  3:  private  (rw) 

No  trap  recipient  configured  yet 

(continued  on  next  page) 
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Community  ■ 

4 :   public    ( ro ) 

No  trap 

recipient  configured  yet 

CommunitY 

5 :    common    ( ro ) 

No  trap 

recipient  configured  yet 

CommunitY 

6:   FibreChannel  (ro) 

No  trap 

recipient  configured  yet 

SNMP  access 

list  configuration: 

Entry  0:     Access  host  subnet  area  192.168.64.0    (rw) ] 

Entry  1 :  No 

access  host  configured  yet 

Entry  2 :  No 

access  host  configured  yet 

Entry  3 :  No 

access  host  configured  yet 

Entry  4 :  No 

access  host  configured  yet 

Entry  5 :  No 

access  host  configured  yet 

See  also 

agtCfgDe fault 
agtCfgSet 
snmpConf ig 
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aliAdd 

Adds  a  member  to  a  zone  alias. 

Synopsis 

aliadd  " aliName",  "member;  member" 

Availability 

admin 


1^)f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  add  one  or  more  members  to  an  existing  zone  alias.  The  alias  member  list  cannot 
contain  another  zone  alias. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Operands 

This  command  has  the  following  required  operands: 

" aliName"  Specify  the  name  of  a  zone  alias,  in  quotation  marks. 

"member"  Specify  a  member  or  list  of  members  to  be  added  to  the  alias,  in 

quotation  marks,  separated  by  semicolons.  An  alias  member 
can  be  specified  by  one  or  more  of  the  following  methods: 

•  A  switch  domain  and  port  area  number  pair.  View  the  area 
numbers  for  ports  using  the  switchShow  command. 

.  VVWN 

•  QuickLoop  AL_PAs 

Examples 

To  add  members  to  zone  aliases  arrayl ,  array 2,  and  loopl : 


switch 

admin> 

aliadd 

" arrayl " 

"1,2" 

switch 

admin> 

aliadd 

" arraY2 " 

"21:00:00:20:37:0c:72:51" 

switch 

ac3inin> 

aliadd 

" loopl " , 

"0x02;  OxEF" 
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See  also 

aliCreate 
aliDelete 
aliRemove 
aliShow 
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aliasDelete 

Deletes  a  port  from  all  local  groups. 

Synopsis 

aliasDelete  portID 

Availability 

admin 

Description 

Use  this  command  to  delete  a  local  port  from  all  local  groups.  The  group  is  deleted  if  it  becomes  empty 
after  deleting  the  local  port. 

Use  the  aliasShow  command  to  show  the  existing  groups  with  its  corresponding  N_Ports. 

Operands 

The  following  aliasDelete  argument  is  required. 
portiD  The  port  ID  in  its  hexadecimal  representation 

Examples 

To  delete  a  port  from  an  existing  group: 

switch : admin>  aliasdelete  0xl9c00 
aliasDelete:  succeeded 


Exit  status 


0  Successful  operation 

Non  Zero  Indicates  the  operation  has  failed 


See  also 

alias Join 
aliasShow 
f abricShow 
switchShow 
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aliasJoin 

Creates  a  group  of  N_Ports.  If  the  group  already  exists,  the  N_Ports  are  added  to  the  existing  group. 

Synopsis 

aliasJoin 

Availability 

admin 

Description 

Use  this  command  to  create  an  alias  group  of  N_Ports  or  to  add  N_Ports  to  an  existent  group.  Any  online 
N  Port  defined  in  the  fabric  can  be  part  of  a  group.  An  N  Port  can  be  added  from  any  switch  that  is  part 
of  the  fabric. 

To  get  a  list  of  online  ports  currently  defined  in  the  fabric,  use  the  nsAllShow  command.  If  the  user  wants 
to  add  only  local  ports  associated  with  the  local  switch,  use  the  nsShow  command  to  get  list  of  ports 
associated  with  the  local  switch. 

Operands 

none 

Examples 


To  create  an  alias  group  of  N  Ports  or  to  add  N  Ports  to  an  existing  group: 

switch : adinin>  aliasJoin 

aliasJoin:  To  add  ports  to  an  existing  or  new  multicast 

group 

Number  of  ports  in  the  group:    {1..64)  [1] 

To  set  an  authorization  password?    (yes,   y,   no,   n) :  [no] 

no  password 

Setting  the  authorization  control 

Add  control:   0  by  any,    1  only  itself,   2  by  creator:  (0.. 

2) 

[0] 

Del  control:   0  by  any,    1  only  itself,   2  by  creator:  (0.. 

2) 

[0] 

Lsn  control:   0  by  any,    1  by  none:    (0..1)  [1] 

Add  control  0,   Del  control  0  Lsn  control  1 

Setting  the  Routing  Bit:    (OxO..Oxc)  [0x0] 

using  FC-4  Device  Data  . . . 

Setting  FC-4  Type:    (0x0..0x5d)  [0x5] 

using  0x05   . .  . 

To  set  the  alias  qualifier  in  WWN  format?     (yes,   y,  no. 

n) 

[yes] 

Qualifier    (in  hex) :  [10:00:00:50:69:80:02:28] 

Port  ID   (in  hex) :    ( 0x0 . . Oxef f aO 0 )    [0]  0xl9c00 

npList[0]   =  0xl9c00 

aliasJoin:  Join  request  to  Group  Address  OxfffbOO  succeeds 
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Exit  status 

0 

Non  Zero 

See  also 

aliasDelete 

aliasPurge 

aliasShow 

f abricShow 

nsAllShow 

nsShow 


Successful  operation 

Indicates  the  operation  has  failed 
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aliasPurge 

Removes  an  alias  group. 

Synopsis 

aliasPurge  groupID 

Availability 

admin 

Description 

Use  this  command  to  remove  an  alias  group. 

Operands 

The  following  aliasPurge  argument  is  required. 
groupiD  It  is  the  group  ID  in  its  hexadecimal  representation 

Examples 

To  remove  an  alias  group: 

switch ; admin>  aliasPurge  OxfffbOO 
aliasPurge:  succeeded 


Exit  status 


0  Successful  operation 

Non  Zero  Indicates  the  operation  has  failed 


See  also 

alias Join 
aliasShow 
f abricShow 
switchShow 
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aliasShow 


Displays  local  alias  server  information. 


Synopsis 


aliasShow 


Availability 

all  users 

Description 

Use  this  command  to  display  local  information.  If  there  is  no  local  alias  group,  a  message  is  displayed.  If 
there  are  multiple  entries  in  the  local  alias  group,  they  are  displayed. 

Operands 

none 

Examples 

To  display  the  entries  in  the  local  alias  server: 


switch : admin>  aliasShow 

{AliasID  Creator  Token   [rb,   type,   grptype,   qlfr]  Member  List 
fffbOO     fffffd   [00,    05,    10,    10000060  69800228]    {  019c00  } 

} 

The  Local  Alias  Server  has  1  entry 


Exit  status 


0 


Non  Zero 


Successful  operation 

Indicates  the  operation  has  failed 


See  also 


f abricShow 


switchShow 
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ali  Create 


Creates  a  zone  alias. 

Synopsis 

alicreate  "aliName",   "member;  member" 

Availability 

admin 


\^^}f  NOTE:    This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  create  a  new  zone  alias.  The  zone  alias  member  list  must  have  at  least  one  member 
(empty  lists  are  not  allov/ed).  The  alias  member  list  cannot  contain  another  zone  alias.  Refer  to  the 
zoneCreate  command  for  more  information  on  name  and  member  specifications. 

Zone  alias  members  can  be  specified  using  the  area  number  to  represent  a  specific  port  and  slot 
combination.  Area  numbers  are  automatically  assigned  to  a  port  by  the  Fabric  OS.  You  can  viev/  the  Area 
numbers  using  the  switchShow  command. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cf  gEnable  command. 


NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  operands: 

"aliName"  Specify  a  name  for  the  zone  alias,  in  quotation  marks.  This 

operand  is  required.  A  zone  alias  name  must  begin  with  a  letter 
and  can  be  followed  by  any  number  of  letters,  digits  and 
underscore  characters.  Names  are  case  sensitive:  for  example, 
"Ali_l"  and  "ali_l"  are  different  zone  aliases.  Spaces  are 
ignored. 

"member"  Specify  a  member  or  list  of  members  to  be  added  to  the  alias,  in 

quotation  marks,  separated  by  semicolons.  An  alias  member 
can  be  specified  by  one  or  more  of  the  following  methods: 

•  A  switch  domain  and  port  area  number  pair.  View  the  area 
numbers  for  ports  using  the  switchShow  command. 

.  WWN 

•  QuickLoop  AL_PAs 
This  operand  is  required. 
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Examples 

To  create  a  zone  alias: 


switch: 

: admin> 

alicreate 

" arrayl " , 

"2,32;    2,33;  2,34" 

switch; 

:  admin> 

alicreate 

" arraY2 " , 

"21:00:00:20:37:0c:66:23" 

switch; 

:  admin> 

alicreate 

" loopl " , 

"0x02;    OxEF;  5,4" 

See  also 

all Add 
allDelete 
allRemove 
aliShow 


42     Fabric  OS  commands 


all  Delete 

Deletes  a  zone  alias. 

Synopsis 

alidelete  " aliName" 

Availability 

admin 


I^Jf  NOTE:    This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  delete  a  zone  alias. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 


NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  sv/i 

Operands 

This  command  has  the  follov/ing  operand: 

"aliName"  Specify  the  name  of  zone  alias  to  be  deleted.  This 

operand  must  be  enclosed  in  quotation  marks.  This 
operand  is  required. 

Examples 

To  delete  the  zone  alias  array2: 


tch. 


switch : admin>  alidelete  "array2' 


See  also 

aliAdd 
aliCreate 
aliRemove 
aliShow 
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aliRemove 


Removes  a  member  from  a  zone  alias. 


Synopsis 


aliremove  "alliVaiue" ,   "member;  member" 


Availability 

admin 


1^)f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  remove  one  or  more  members  from  an  existing  zone  alias. 
If  all  members  are  removed,  the  zone  alias  is  deleted. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cf  gEnable  command. 


1^)f  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  sv/itch. 


Operands 


This  command  has  the  follov/ing  operands: 


"  aliName" 


member 


Specify  the  name  of  the  zone  alias  to  have  members  removed,  in 
quotation  marks.  This  operand  is  required. 

Specify  a  member  or  list  of  members  to  be  removed  from  the 
alias,  in  quotation  marks,  separated  by  semicolons.  An  alias 
member  can  be  specified  by  one  or  more  of  the  follov/ing 
methods: 

•  A  sv/itch  domain  and  port  area  number  pair.  View  the  area 
numbers  for  ports  using  the  switchShow  command. 

.  WWN 

•  QuickLoop  AL_PAs 

This  operand  is  required.  The  member  list  is  located  by  an  exact 
string  match;  therefore,  it  is  important  to  maintain  the  order 
when  removing  multiple  members.  For  example,  if  a  zone  alias 
contains  "1,2;  1,3;  1,4",  then  removing"l ,3;  1,4"  succeeds  but 
removing  "1,4;  1,3"  fails. 
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Examples 

Remove  a  World  Wide  Name  from  "array  1 ": 


switch: 

:  adinin> 

aliremove 

"arrayl " , 

"3,5" 

switch; 

:  adinin> 

ali remove 

" arrayl " , 

"21:00:00:20:37:0c:76:8c" 

switch; 

:  ad[nin> 

aliremove 

" arrayl " , 

" OxEF" 

See  also 

ali Add 
aliCreate 
allDelete 
aliShow 
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aliShow 

Displays  zone  alias  information. 

Synopsis 

alishow  ["pattern"  ]  [,  mode] 

Availability 

all  users 


1^)f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  display  zone  configuration  information. 

If  a  parameter  is  specified,  it  is  used  as  a  pattern  to  match  zone  alias  names;  those  that  match  in  the 
defined  configuration  are  displayed. 

NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  PCS  switch. 

Operands 

This  command  has  the  following  optional  operands: 

"pattern"  A  POSIX-style  regular  expression  used  to  match  zone  alias 

names.  This  operand  must  be  enclosed  in  quotation  marks. 
Patterns  can  contain: 

•  Question  mark  (?),  which  is  a  placeholder  for  any  single 
character 

•  Asterisk  (*),  which  is  a  placeholder  for  any  string  of 
characters 

•  Ranges,  which  are  a  placeholder  for  any  character  within  the 
range.  Ranges  must  be  enclosed  in  brackets:  for  example, 
[0-9]  or  [a-f]. 

mode  Specify  0  to  display  the  contents  of  the  transaction  buffer  (the 

contents  of  the  current  transaction),  or  specify  1  to  display  the 
contents  of  the  flash  memory.  The  default  value  is  0 

If  no  parameters  are  specified,  all  zone  configuration  information  (both  defined  and  effective)  is  displayed. 
Refer  to  cf  gShow  for  a  description  of  this  display. 

Examples 

To  display  all  zone  aliases  beginning  with  "arr": 


switch 

admin> 

alishow  "arr*" 

alias : 

arrayl 

21:00:00:20:37 

Oc 

76:8c 

alias : 

arraY2 

21:00:00:20:37 

Oc 

66:23 
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See  also 

aliAdd 
aliCreate 
aliDelete 
aliRemove 
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aptPolicy 

Changes  or  displays  the  Advanced  Performance  Tuning  (APT)  policy. 

Synopsis 


aptpolicy  [policy] 


Availability 

admin 


"2^  NOTE:   This  command  is  available  only  on  the  HP  StorageWorks  SAN  Switch  4/32. 


Description 

Use  this  command  to  change  the  performance  algorithm  on  the  sv/itch.  A  number  of  internal  parameters 
are  changed  by  the  use  of  this  command,  and  a  detailed  performance  tuning  discussion  is  beyond  the 
scope  of  this  manual.  The  default  parameters  are  optimal  for  most  SAN  applications,  and  typical 
customers  do  not  need  to  use  this  command. 

When  used  with  no  arguments,  this  command  displays  a  list  of  APT  policies  supported  on  this  switch,  as 
well  as  the  current  policy.  This  can  be  done  at  any  time. 

The  switch  must  be  disabled  before  using  this  command  to  change  the  current  policy. 

Operands 

This  command  has  the  following  operand: 

policy  Specifies  the  new  APT  policy.  The  following  polices  are  supported: 

•    Port-based  routing  policy 

With  this  policy,  the  path  chosen  for  an  ingress  frame  is  based  on: 

•  Ingress  port  on  which  the  frame  was  received 

•  Destination  domain  for  the  frame 

The  chosen  path  remains  the  same  if  Dynamic  Load  Sharing  (DLS)  feature  is 
not  enabled.  If  DLS  is  enabled,  then  a  different  path  may  be  chosen  on  a 
fabric  event.  Refer  to  dlsSet  for  the  definition  of  a  fabric  event. 

This  policy  may  provide  better  ISL  utilization  when  there  is  little  or  no 
oversubscription  of  the  ISLs. 

Note  that  static  routes  are  supported  only  with  this  policy. 
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Device-based  routing  policy 

With  this  policy,  the  path  chosen  for  an  ingress  frame  is  based  on: 

•  Ingress  port  on  which  the  frame  was  received 

•  FC  address  of  the  source  fabric  device  (SID)  for  this  frame 

•  FC  address  of  the  destination  fabric  device  (DID)  for  this  frame 

This  policy  allows  for  better  utilization  of  the  available  paths  as  I/O  traffic 
between  different  (SID,  DID)  pairs  can  use  different  paths.  All  frames  received 
on  a  ingress  port  with  the  same  (SID,  DID)  parameters  takes  the  same  path 
unless  there  is  a  fabric  event.  Refer  to  dlsSet  for  the  definition  of  a  fabric 
event. 

This  policy  does  not  support  static  routes.  DLS  always  is  enabled  and  the  DLS 
setting  cannot  change  with  this  policy. 

Exchange-based  routing  policy 

With  this  policy,  the  path  chosen  for  an  ingress  frame  is  based  on: 
Ingress  port  on  which  the  frame  was  received 

•  FC  address  of  the  SID  for  this  frame 

•  FC  address  of  the  DID  for  this  frame 

•  FC  Originator  Exchange  ID  (OXID)  for  this  frame 

This  policy  allows  for  optimal  utilization  of  the  available  paths  as  I/O  traffic 
between  different  (SID,  DID,  OXID)  pairs  can  use  different  paths.  All  frames 
received  on  a  ingress  port  with  the  same  (SID,  DID,  OXID)  parameters  takes  the 
same  path  unless  there  is  a  fabric  event.  Refer  to  dIsSet  for  the  definition  of  a 
fabric  event. 

This  policy  does  not  support  static  routes.  DLS  always  is  enabled  and  the  DLS 
setting  cannot  change  with  this  policy. 
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Examples 

To  display  the  current  policy  and  then  change  it  from  an  exchange-based  to  a  device-based  policy: 


See  also 


switch: admin>  aptpolicy 
Current  Policy:  3 

3:  Default  Policy 

1  ■     T^r^Y"\~    R^GoH  Rr^iil — i  T\rr    Pi^l  i  f~'\/' 
_L  .     iri^j-  1^    x_> ci o c vJ.    rv"^ u.  1  Liiy     cy^j  y 

2 :  Device  Based  Routing  Policy 
3 :  Exchange  Based  Routing  Policy 

switch : adinin>  aptpolicy  2 

Switch  must  be  disabled  in  order  to  modify 
parameter.  To  disable  the  switch,  use  the 

this  configuration 
switchDisable"  command. 

switch : admin>  switchdisable 

switch : admin>  aptpolicy  2 
Policy  updated  successfully. 

switch :admin>  switchenable 

switch :admin>  aptpolicy 
Current  Policy:  2 

3:  Default  Policy 
1:   Port  Based  Routing  Policy 
2 :  Device  Based  Routing  Policy 
3 :   Exchange  Based  Routing  Policy 

dlsReset 

dlsSet 

dlsShow 

switchDi sable 
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authUtil 


Displays  and  sets  the  authentication  configuration. 

Synopsis 

authutil  [--show] [--set  value] 

Availability 

admin 

Description 

Use  this  command  to  display  and  set  local  switch  authentication  parameters.  Use  --set  to  change 
authentication  parameters,  such  as  protocol  and  Diffie-Hellman  group  (DH  group),  which  saves  new 
configuration  persistently.  Authentication  process  uses  the  protocol  that  is  set  using  this  command. 

When  no  protocol  is  set,  the  default  setting  of  f  cap,  dhchap  is  used.  The  default  setting  of  "  *  "  (for 
example,  0,1,2,3,4)  is  used  when  no  group  is  set.  The  new  configuration  is  effective  with  the  next 
authentication  request. 

Use  --show  to  display  the  current  authentication  configuration  of  the  switch.  Use  the  portShow 
command  to  display  the  authentication  type  and  associated  parameters,  if  applicable,  used  on  the  port  at 
port  online  or  when  enabling  security,  whichever  occurs  last. 


NOTE:    A  security  license  is  required  to  run  this  command  in  nonsecure  as  well  as  secure  mode. 


Operands 

This  command  has  the  following  operands: 

--show  Displays  local  authentication  configuration. 

Modifies  authentication  configuration.  Values  include: 

-a  Sets  authentication  protocol.  Specify  f  cap  to  set  only  FCAP 

authentication,  dhchap  to  set  only  DH-CHAP  authentication, 
and  all  to  set  both  FCAP  and  DH-CHAP  (default).  When 
authentication  is  set  to  all,  implicit  order  is  FCAP  followed 
by  DH-CHAP;  for  example,  in  authentication  negotiation 
FCAP  is  given  priority  over  DH-CHAP  on  the  local  switch, 
however  a  responder  can  still  select  DH-CHAP. 

-g  Sets  DH  group.  Values  0  to  4  and  "  * "  are  valid  values.  DH 

group  0  is  called  NULL  DH.  A  user  can  select  other  groups 
between  1  and  4.  Each  DH  group  specifies  a  key  size  and 
associated  parameters  implicitly.  Higher  group  value 
provides  stronger  cryptography  and  higher  level  of  security 
in  authentication  protocol.  When  DH  group  is  set  to  a 
specified  value,  only  that  DH  group  is  enabled  in 
authentication.  Specifying  "  *  "  as  a  group  enables  all  DH 
groups  0,  1,2,  3,  and  4,  in  that  order;  for  example,  in 
authentication  negotiation  NULL  DH  is  given  priority  over 
other  groups,  however  a  responder  can  still  select  other  DH 
group. 

Without  any  specified  operands,  the  command  displays  the  usage. 
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Examples 

To  display  authentication  configuration  on  the  switch: 

switch : admin>  authutil  --show 

AUTH  TYPE  HASH  TYPE  GROUP  TYPE 


dhchap  shal,md5  0,1,2,3,4 

To  set  DH-CHAP  as  authentication  protocol: 

switch : admin>  authutil  --set  -a  dhchap 
Authentication  is  set  to  dhchap. 

To  set  both  protocols  in  order  of  f  cap,  dhchap: 

switch : admin>  authutil  --set  -a  all 
Authentication  is  set  to  f cap, dhchap. 

To  set  DH  group  3: 

switch : admin>  authutil  --set  -g  3 
DH  Group  was  set  to  3 . 

To  set  all  DH  groups  to  be  specified  in  auth  negotiate  in  order  of  0,  1,  2,  3,  and  4: 

switch : admin>  authutil  --set  -g  "*" 
DH  Group  is  set  to  0,1,2,3,4 

See  also 

portShow 
secAuthSecret 
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backplanetest 

Tests  backplane  connection  for  a  multiple-blade  configured  system. 

Synopsis 

backplanetest   [--slot  number]  [-passcnt  count] [-payload  value]  [-pat 
type] [-ports  itemlist]  [-verbose  mode] 

Availability 

admin 

Description 

Use  this  command  to  verify  the  backplane  connection  for  each  blade  through  the  backend  external  (BE) 
ports.  This  command  can  only  run  on  a  multiple-blade  configured  system.  It  assumes  that  all  blades 
available  on  the  specified  sv/itch  have  passed  the  blade  diagnostic  tests.  This  command  is  not  part  of 
bladediag  or  bladediagsliort.  This  command  verifies  backplane  connection  by  using  a  functional 
blade's  frame  transmitter/ receiver  features. 

'2^^  NOTE:    No  other  diagnostic  can  be  executed  until  this  test  is  completed. 


Operands 

This  command  has  the  following  operands: 

--slot  number  Specifies  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director  2/1  28. 

For  all  other  switches,  this  operand  is  not  required.  The  slot  number  must  be 
followed  by  a  slash  (/)  and  the  port  number,  so  that  each  port  is 
represented  by  both  a  slot  number  (1  through  4  or  7  through  1 0)  and  a 
port  number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/128  have  a  total  of  10  slots. 
Slot  numbers  5  and  6  are  control  processor  cards;  slots  1  through  4  and  7 
through  1 0  are  port  cards.  On  each  port  card,  there  are  1 6  ports,  counted 
from  the  bottom,  numbered  0  to  15. 

-passcnt  count  Specifies  the  number  of  times  to  perform  this  test.  The  default  value  is  1 .  This 

operand  is  optional. 

-payload  value  Specifies  the  byte  size  of  the  test  frame  payload.  The  payload  size  must  be 

in  multiples  of  4,  and  the  minimum  size  is  1 6.  The  default  value  is  5 1 2 
bytes.  This  operand  is  optional. 

-pat  type  Specifies  the  test-pattern  type  used  in  the  test  frame  payload.  The  default  test 

is  17(jCRPAT).  The  following  test  patterns  can  be  specified: 


1 

byte  fill 

2 

word  fill 

3 

quad  fill 

4 

byte  not 

5 

word  not 

6 

quad  not 

7 

byte  ramp 
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8 

word  ramp 

9 

quad  ramp 

10 

byte  Ifsr 

1 1 

random 

12 

crpat 

13 

cspat 

14 

chalf  sq 

15 

cqtr  sq 

16 

rdram  pat 

17 

jCRPAT  (default) 

18 

jCJTPAT 

19 

jCSPAT 

-ports  itemlist         Specifies  a  list  of  blade  ports  to  test.  By  default,  all  the  blade  ports  in  the 

specified  slot  are  used.  Refer  to  itemList  help  pages  for  further  details 

-verbose  mode  Specifies  verbose  mode.  If  specified  with  a  nonzero  value,  this  mode 

displays  the  test  progress  in  detail.  The  default  value  is  to  disable  the  mode. 
This  operand  is  optional. 

Examples 

To  test  backplane  connections  on  a  Core  Switch  2/ 64  or  SAN  Director  2/1 28: 


swi  tch : admin> 

backplanetest  -ports  1/16, 

18,   20  -payload  2048  -verbose  1 

Running  backplanetest   

Test  frame  info  for  Backplane  Connection 

Test : 

#  of  frames: 

1 

sid  data: 

Oxff ff fd 

did  data: 

Oxff ff fd 

payload  size: 

2048  bytes 

Test  Complete 

:  backplanetest  Pass  1  of  1 

Duration  0  hr, 

,    0  min  &  1  sec  (0:0:1:715) 

passed. 

Diagnostics 

When  this  command  detects  failure(s),  the  subtest  might  report  one  or  more  of  the  following  error 
messages: 

DATA 

TIMEOUT 

XMIT 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

itemList 
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backport 


Tests  for  backend  ASIC-to-ASIC  links. 


Synopsis 


backport  [-nframes  count] [-ports  itemlist]  [-lb_mode  mode]  [-fr_type 
type] [-extonly  mode] 


Availability 


admin 


Description 

Use  this  command  to  test  the  backplane  routing  and  virtual  channel  (VC)  allocation.  This  test  applies  to 
single  blade  as  well  as  multiblade  systems. 

The  following  items  are  tested: 

•  Proper  backend  port  domain  routing  setup  such  that  every  user  port  has  a  valid  path  to  every  other 
user  port.  If  a  valid  path  does  not  exist  between  any  two  user  ports,  that  path  will  fail  to  transmit  the 
first  frame  between  the  two  ports. 

•  Proper  virtual  channel  mapping  such  that  an  arbitrarily  large  number  of  frames  might  be  transmitted 
without  running  out  of  credit.  If  the  VC  credit  mapping  is  not  correct  then  the  test  will  fail  after  enough 
frames  have  been  sent  to  exhaust  the  initial  credit. 

•  Proper  trunking  of  backend  ports.  The  frames  send  in  bursts.  If  the  trunking  is  not  set  up  properly,  the 
burst  of  frames  do  not  arrive  in-order. 

•  ASIC  errors  along  each  path.  The  test  checks  for  CRC  and  ENC  errors  for  each  port  used  between  the 
source  and  destination  ports  to  help  isolate  failures.  It  also  checks  that  each  member  of  every  trunk 
group  along  the  path  has  sent  or  received  at  least  one  frame. 

Area  routing  between  user  ports  is  not  tested.  Use  of  this  command  assumes  that  the  same  database  is 
used  for  domain  and  area  routes;  therefore,  domain  results  are  indicative  of  area  operation. 


\^^f  NOTE:    Virtual  channel  mapping  is  not  tested  if  -extonly  is  set  to  1 . 


Options 


This  command  has  the  following  options: 


-ports  itemlist 


-nframes  count 


Specifies  the  number  of  frames  per  port  to  send.  The  test  runs  until  the 
specified  number  of  frames  have  been  transmitted  on  each  port.  The 
total  number  of  frames  that  this  command  circulates  is  determined  at 
run  time.  The  default  value  is  1 0  and  the  minimum  value  is  -1 .  Any 
value  less  than  the  minimum  is  ignored  and  the  minimum  value  of  -1  is 
used. 

Specifies  a  list  of  user  ports.  The  default  value  is  all  user  ports.  Refer  to 
itemList  for  more  information. 
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Selects  the  loopback  point  for  the  test.  By  default,  bockport  uses 
internal  loopback. 

Mode  Description 

1  Port  loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 
5  Internal  (parallel)  loopback 

Specifies  the  frame  type  to  send.  The  default  value  is  1 . 

Type  Description 

0  Single  frame 

1  spinfab  frames 

2  spinfab  1 K  frames 

Specifies  externa  I -test-only  mode.  The  default  value  is  0,  which  disables 
this  mode.  This  command  normally  sends  bursts  of  frames  from  each 
port  under  test  to  every  other  port  in  the  list.  With  -extonly  mode  set  to 
1 ,  the  command  sends  only  one  burst  of  frames  to  each  port  from  each 
ASIC  pair-to-ASIC  pair  link.  This  tests  all  of  the  external  connections 
with  only  K  *  N  frames  instead  of  the  N'^2  frames  required  in  all-to-all 
mode. 

This  mode  is  intended  to  be  used  in  ESS/burn-in  testing  to  optimize  test 
time,  backport  tests  only  the  external  connections  between  each 
ASIC  pair.  txdPath  is  used  to  test  the  internal  ASIC  pair-to-ASIC  pair 
paths.  The  values  are: 

0  Send  frames  from  all  ports  to  all  other  ports. 

1  Send  only  one  burst  of  frames  to  each  link. 

Examples 

To  test  for  backend  ASIC  pair  links: 


switch :  adinin>  backport  ■ 

-ports  1/1-1/3  -nframes  10 

One  moment  please   . . . 

backport  running. . . 

backport:  Completed  840 

frames,   status:  passed. 

Diagnostics 

When  the  command  detects  failure(s),  the  test  can  report  one  or  more  of  the  following  error  messages: 

ERR_STAT 

ERR_STATS 

INIT 

PORT_DIED 

PORT_STOPPED 

XMIT 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

cross PortTest 
itemList 

portLoopbackTest 


-lb_mode  mode 


-fr_type  type 


-extonly  mode 
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spinFab 

spinSilk 

txdPath 
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bannerSet 

Sets  the  banner  on  the  local  switch. 

Synopsis 

bannerset  [banner] 

Availability 

admin 

Description 

Use  this  command  to  set  the  banner  on  the  local  switch. 

The  banner  is  a  string  of  alphanumeric  characters.  It  is  displayed  whenever  a  user  tries  to  log  in  to  a 
switch. 

The  banner  can  be  created  using  the  bonner  operand  or  by  entering  the  bannerSet  command  without 
an  operand,  making  the  session  interactive. 

If  you  enter  the  banner  text  using  the  interactive  method,  the  valid  length  is  1 022  characters.  If  the  banner 
text  length  exceeds  the  maximum  allowed,  the  software  truncates  the  input.  To  close  the  banner  text  string, 
enter  a  period  at  the  beginning  of  a  new  line. 

Operands 

This  command  has  the  following  operand: 

banner  Specify  a  text  string  to  be  displayed  when  a  user  logs  in.  If  you 

enter  the  banner  text  using  the  banner  operand,  the  valid 
length  is  1 16  characters.  This  operand  is  optional. 

Examples 

To  set  a  new  banner  for  a  switch: 

switch : admin>  bannerset   "My  banner" 

switch : admin>  bannerSet 

Please  input  context  of  security  banner  (press  " . "  RETURN  at  the 
beginning  of  a  newline  to  finish  input) :   Do  not  log  into  this 
switch  if  you  are  not  an  authorized  administrator. 


See  also 

bannerShow 
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bannerShow 

Displays  the  banner  text. 

Synopsis 

bannershow 

Availability 

admin 

Description 

Use  this  command  to  display  the  contents  of  the  banner. 

Operands 

none 

Examples 

To  display  the  banner  for  a  switch: 

switch :  adinin>  bannershow 
Banner : 

Do  not  log  into  this  switch  if  you  are  not  an  authorized  administrator. 

See  also 

bannerSet 
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bcastShow 


Displays  broadcast  routing  information. 


Synopsis 

bcastshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  broadcast  routing  information  for  all  ports  in  the  switch.  The  broadcast 
routing  information  indicates  all  ports  that  are  members  of  the  broadcast  distribution  tree:  ports  that  are 
able  to  send  and  receive  broadcast  frames. 

Normally,  all  F  Ports  and  FL  Ports  are  members  of  the  broadcast  distribution  tree.  The  broadcast  path 
selection  protocol  selects  the  E_Ports  that  are  part  of  the  broadcast  distribution  tree.  The  E_Ports  are  chosen 
in  such  a  way  to  prevent  broadcast  routing  loops. 

The  following  fields  display: 

Group  The  multicast  group  ID  of  the  broadcast  group  (always  256) 

Member  Ports  A  map  of  all  ports  in  broadcast  tree 

Member  ISL  Ports  A  map  of  all  E_Ports  in  broadcast  tree 

The  broadcast  routing  information  for  the  ports  is  displayed  as  a  set  of  hexadecimal  bit  maps.  Each  bit  in 
a  bit  map  represents  a  port,  with  the  least  significant  bit  in  each  row  representing  port  0,  32,  64,  and  so 
on.  For  more  information  on  reading  hexadecimal  bit  maps,  refer  to  the  HP  StorageWorks  Fabric  OS  4.x 
procedures  user  guide. 


NOTE:    The  output  from  this  command  varies,  depending  on  switch  type. 


When  this  command  runs  on  a  1 28-port  switch,  the  member  ports  consist  of  ports  7,  1 3,  42,  84,  85,  and 
86.  The  final  member  ports  bit  set  represents  the  embedded  port  (frames  sent  to  be  handled  by  firmware) 
and  is  typically  set. 


Operands 


none 
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Examples 


To  display  the 

broadcast  routing 

information  for  all  ports  in  the  switch: 

switch: 

adinin>  bcastShow 

Group 

Member  Ports 

Member  ISL  Ports 

256 

0x00012083 

0x00002080 

0x00000440 

0x00000400 

0x00770000 

0x00700000 

0x00008200 

0x00000000 

0x00000001 

0x00000000 

See  also 

portRouteShow 
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bladeBeacon 


Sets  blade  beaconing  mode  on  or  off. 


Synopsis 


bladebeacon   [slotnumber]  mode 


Availability 


admin 


\^^}f  NOTE:   This  command  is  only  available  on  the  Core  Switch  2/64  and  SAN  Director  2/128. 


Use  this  command  to  enable  or  disable  blade  beaconing  or  to  display  the  current  beaconing  mode  for 


When  beaconing  is  enabled,  the  port  LEDs  flash  amber  in  a  running  pattern  from  port  0  through  port  1 5 
and  back  again.  The  pattern  continues  until  the  user  turns  it  off.  This  can  be  used  to  locate  a  physical  unit. 

Beaconing  mode  only  takes  over  the  port  LEDs;  it  does  not  change  the  sv^itch's  functional  behavior.  The 
normal  flashing  LED  pattern  (associated  with  an  active,  faulty,  or  disabled  port,  for  example)  is  suppressed 
and  only  the  beaconing  pattern  is  displayed.  If  a  diagnostic  frame-based  test  (such  as 
portLoopbackTest,  crossPortTest,  or  spinSilk)  is  executed,  the  two  LED  patterns  are 
interwoven.  The  diagnostic  test  flickers  the  LEDs  green  and  the  beaconing  mode  runs  the  LEDs  amber. 

The  switchShow  command  can  be  used  to  display  if  the  status  of  blade  beaconing  mode  is  on  or  off. 


Description 


one  blade. 


Operands 


This  command  has  the  following  operands: 


mode 


slotnumber 


Specifies  the  slot  number  to  enable  bladeBeacon. 

Specifies  a  value  of  1  to  set  beaconing  mode  on.  Specifies  a  value  of  0 
to  set  beaconing  mode  off.  This  operand  is  optional;  if  omitted,  the 
current  mode  displays. 


Examples 


To  enable  beaconing  on  slot  3,  display  the  beaconing  mode,  the  disable  the  slot: 


switch : admin>  bladebeacon  2  1 


switch :  ac3inin>  bladebeacon  2 


value  =  1 


switch : admin>  bladebeacon  2  0 


See  also 


switchShow 
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bladeDisable 


Disables  all  user  ports  on  a  blade. 

Synopsis 

bladedisable  [slotnumber] 

Availability 

admin 

Description 

Use  this  command  to  disable  all  user  ports  on  a  blade.  All  Fibre  Channel  ports  are  taken  offline.  If  the 
switch  was  connected  to  a  fabric  through  this  blade,  the  remaining  switches  reconfigure,  and  this  switch 
will  configure  based  on  the  other  blade  ports. 

The  blade  must  be  disabled  before  making  configuration  changes  or  before  running  many  of  the 
diagnostic  tests. 

The  blade  does  not  need  to  be  disabled  before  rebooting  or  powering  off. 

Observe  and  verify  the  disable  process  by  watching  the  front  panel  LEDs  change  to  slow  flashing  yellow 
as  each  port  of  the  blade  disables. 

NOTE:  A  blade  cannot  be  disabled  or  enabled  when  the  switch  is  disabled  or  when  the  blade  itself  is 
disabled  (using  slotof  f),  faulted,  powered  off,  or  running  diagnostics. 


Operands 

This  command  has  the  following  operand: 

slotnumber  Specifies  the  slot  number  on  which  the  ports  are  to  be  disabled. 
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Examples 

To  disable  blade  2  and  then  verify: 


admin>  bladedisable  2 

Blade  2 

is 

being 

disabled. 

. . Done 

switch: 

admin>  slotshow 

Slot 

Blade  Type 

ID 

Status 

1 

sw 

BLADE 

2 

ENABLED 

2 

sw 

BLADE 

2 

ENABLED  (User  Ports  Disabled) 

3 

sw 

BLADE 

2 

ENABLED 

4 

sw 

BLADE 

2 

ENABLED 

5 

CP 

BLADE 

1 

ENABLED 

6 

CP 

BLADE 

1 

ENABLED 

7 

sw 

BLADE 

2 

ENABLED 

8 

sw 

BLADE 

2 

ENABLED 

9 

sw 

BLADE 

2 

ENABLED 

10 

sw 

BLADE 

2 

ENABLED 

See  also 

bladeEnable 
portDisable 
portEnable 
slotOf f 
switchShow 
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bladeEnable 


Enables  all  user  ports  on  a  blade. 

Synopsis 

bladeenable  [slotnumber] 

Availability 

admin 

Description 

Use  this  command  to  enable  all  user  ports  on  a  blade.  All  Fibre  Channel  ports  within  the  blade  that  did 
not  fail  the  power-on  self-test  (POST)  are  enabled  (except  for  persistently  disabled  ports);  they  might  come 
online  if  connected  to  a  device  or  remain  offline  if  disconnected. 

If  the  switch  is  connected  to  a  fabric,  it  rejoins  the  fabric.  If  this  switch  remains  the  principal  switch  at  the 
end  of  the  countdown,  then  it  assigns  itself  a  domain  ID.  If  another  switch  assumes  the  principal  role,  then 
this  switch  becomes  a  subordinate  switch  and  accepts  a  domain  ID  from  the  principal.  Refer  to  FC-SW  for 
a  complete  description  of  this  process. 

Observe  and  verify  the  enable  process  by  watching  the  front-panel  LEDs  change  from  slow  flashing  amber 
as  each  port  enables.  The  LEDs  change  to  green  for  online  ports,  unlighted  for  disconnected  ports,  or 
amber  for  ports  that  do  not  initialize. 


\^^}f  NOTE:  A  blade  cannot  be  disabled  or  enabled  when  the  switch  is  disabled  or  when  the  blade  itself  is 
C— I    disabled  (using  slotof  f),  faulted,  powered  off,  or  running  diagnostics. 

Persistently  disabled  ports  are  not  enabled  by  this  command. 


Operands 

This  command  has  the  following  operand: 

slotnumber  Specifies  the  slot  number  to  be  enabled. 

Examples 


To  display  the 

slot  status,  ena 

ble  the 

user  ports  in  slot  4,  and  verify  the  setting: 

switch: 

admin>  slotshow 

Slot 

Blade  Type 

ID 

status 

1 

SW  BLADE 

2 

ENABLED 

2 

UNKNOWN 

VACANT 

3 

UNKNOWN 

VACANT 

4 

SW  BLADE 

2 

ENABLED  (User  Ports  Disabled) 

5 

CP  BLADE 

1 

ENABLED 

6 

CP  BLADE 

1 

ENABLED 

7 

SW  BLADE 

2 

ENABLED 

(continued  on  next 

page) 
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8 

UNKNOWN 

VACANT 

9 

UNKNOWN 

VACANT 

J-  u 

UiMiMMUWlM 

V  AC/ilN  1 

switch: 

admin>  bladeenable 

4 

slBlade  4  is  being  enabled ...  Done 

switch: 

admin>  slotshow 

Slot 

Blade  Type  ID 

Status 

1 

SW  BLADE  2 

ENABLED 

2 

UNKNOWN 

VACANT 

3 

UNKNOWN 

VACANT 

4 

SW  BLADE  2 

ENABLED 

5 

CP  BLADE  1 

ENABLED 

6 

CP  BLADE  1 

ENABLED 

7 

SW  BLADE  2 

ENABLED 

8 

UNKNOWN 

VACANT 

9 

UNKNOWN 

VACANT 

10 

UNKNOWN 

VACANT 

See  also 

bladeDisable 

portDisable 

portEnable 

slotOf f 

slotOn 

switchShow 
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burninErrClear 


Clears  errors  stored  in  the  nonvolatile  storage  on  the  slot  during  burn-in. 

Synopsis 

burninErrClear  slotNum 

Availability 

admin 

Description 

Use  this  command  to  clear  errors  stored  in  the  nonvolatile  storage  on  the  slot  during  burn-in. 

Operands 

This  command  has  the  following  operand: 

slotNum  A  nonzero  value  that  specifies  the  slot  number  from  which  to 

clear  burn-in  errors. 

Examples 

To  clear  burn-in  errors  from  slot  2. 

switch :  adinin>  burninErrClear  2 

See  also 

burninErrShow 
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burninErrShow 


Displays  errors  stored  in  the  nonvolatile  storage  on  the  slot  during  burn-in. 

Synopsis 

burninErrShow  slotNum 

Availability 

all  users 

Description 

Use  this  command  to  display  errors  stored  in  the  nonvolatile  storage  on  the  slot  during  burn-in. 

Operands 

This  command  has  the  follov/ing  operand: 

slotNum  A  nonzero  value  that  specifies  the  slot  number  from  which  to 

display  burn-in  errors. 

Examples 

To  display  burn-in  errors  from  slot  2: 

switch : admin>  burninErrShow  2 

See  also 

burninErrClear 
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burninLevel 

Sets  the  diagnostics  burn-in  level. 

Synopsis 

burninlevel    [  level    \    -show  ] 

Availability 

admin 


Description 

Use  this  command  to  select  or  display  the  burn-in  level.  When  the  burn-in  level  is  set  to  a  value  other  than 
0,  the  diagnostic  daemon  program  performs  burn-in  testing  in  place  of  the  pov/er-on  self-test  (POST)  phase 
II  each  time  a  sv/itch  blade  is  povvered  on.  The  mode  becomes  active  as  soon  as  this  command  is 
executed  so  that  it  does  not  require  a  reboot  to  take  effect. 

When  a  burn-in  level  other  than  0  is  selected,  actual  behavior  is  determined  by  the  configuration  of  the 
diagnostics  daemon  and  the  burn-in  scripts  run. 

A  useful  application  of  this  command  is  to  store  errors  on  the  local  persistent  error  storage  on  which  the 
error  occurs.  This  happens  when  the  burn-in  level  is  other  than  0.  This  preserves  the  errors  prior  to 
returning  a  board  for  service.  For  multibladed  products,  this  is  the  independent  blade,  and  for 
fixed-port-count  products,  this  is  the  chassis-persistent  storage.  The  error  logs  are  viewed  using  the 

burninErrShow  command. 

Options 

The  following  are  optional: 
level  The  burn-in  level  sets  to  this  value. 

-show  If  specified,  or  if  level  is  not  specified,  the  current  burn-in  level 

setting  displays. 

Examples 

To  set  the  diagnostic  burn-in  level: 


switch : adinin>  burninlevel  -show 
Burnin  level  is  0. 


See  also 

burninErrShow 
diagDisablePost 
diagEnablePost 
diagSetBurnin 
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burninStatus 

Displays  the  diagnostics  burn-in  status. 

Synopsis 

burninstatus    [ [   --slot  ]    slotnumber  ] 

Availability 

admin 

Description 

Use  this  command  to  display  the  burn-in  status  of  each  blade  in  the  system.  The  output  contains  the  slot, 
state,  current  run  number,  current  command  in  the  run,  total  commands  in  a  run,  and  the  burn-in  script 
name. 

Operands 

The  following  operands  are  optional: 

--slot  slotnumber  Optional  specify  to  get  the  burn-in  status  of  a  single  slot.  If  not 

specified,  all  slots  are  displayed. 

Examples 

To  display  the  burn-in  status  for  all  slots: 


switch: 

admin>  burninstatus 

Slot 

State  Status 

Run 

Cmd 

TotCmds 

PID 

Script 

1 

ABORT  PASS 

3 

18 

41 

916 

burnin 

2 

ABORT  PASS 

3 

18 

41 

920 

burnin 

3 

ABORT  PASS 

3 

18 

41 

923 

burnin 

4 

ABORT  FAIL 

3 

11 

34 

926 

burnin 

To  display  the 

burn-in  status  for  slot  3: 

switch: 

admin>  burninstatus  -- 

slot  3 

Slot 

State  Status 

Run 

Cmd 

TotCmds 

PID 

Script 

3 

ABORT  PASS 

3 

18 

41 

923 

burnin 

See  also 

diagSetBurnin 
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camTest 


Verifies  QuickLoop's  Content  Addressable  Memory  (CAM)  SID  translation. 


Synopsis 

camtest   [--slot  slotnumber]  [-passcnt  count] [-txport  itemlist] 

Availability 

admin 

Description 


Use  this  command  to  verify  that  the  CAM  is  functionally  OK  by  performing  hit  and  miss  tests.  The  CAM  is 
used  by  QuickLoop  to  translate  the  SID. 

When  a  CAM  is  presented  with  a  data,  it  checks  if  the  data  is  present  in  its  memory.  A  hit  means  the  data 
is  found  in  the  CAM.  A  miss  means  the  data  is  not  found. 

In  this  test,  the  CAM  is  filled  with  four  kinds  of  data  patterns: 

•  A  walking  1 

•  A  walking  0 

•  A  random  pattern 

•  An  inverted  version  of  the  random  pattern  above 

Once  filled  with  each  of  the  patterns  above,  a  frame  is  sent  and  looped  back  internally.  If  a  hit  is  expected 
(when  the  random  or  inverted  random  pattern  is  used)  the  original  SID  in  the  frame  transmitted  is  received 
translated  with  the  domain  and  area  fields  of  the  SID  zeroed.  If  a  miss  is  expected  (when  the  walking  1  or 
walking  0  pattern  is  used)  the  original  SID  in  the  frame  transmitted  is  received  unchanged. 


NOTE:  This  command  cannot  be  executed  on  an  enabled  switch.  You  must  first  disable  the  switch  using 
the  switchDisable  command. 


Operands 


This  command  has  the  following  operand: 


-passcnt  count 


--slot  slotnumber 


txport  itemlist 


Specifies  the  slot  number  on  which  the  diagnostic  will  operate. 
The  ports  specified  will  be  relative  to  this  slot  number.  The  default 
is  set  to  0  and  designed  to  operate  on  fixed-port-count  products. 

Specifies  the  number  of  times  to  perform  this  test.  The  default 
value  is  1 . 

Specifies  a  list  of  blade  ports  to  test.  By  default,  all  the  blade 
ports  in  the  specified  slot  (--slot)  will  be  used.  Refer  to 
itemList  for  more  information. 
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Examples 

To  verify  CAM  is  functioning  correctly: 


switch: admin>  camtest  -txports  1/1 

Running  camtest   

Test  Complete:    "camtest"  Pass  1  of  1 
Duration  0  hr,    0  min  &  5  sec  (0:0:5:14). 
passed. 

Diagnostics 

Wfien  failures  are  detected,  the  subtest  might  report  one  or  more  of  the  following  error  messages: 

DIAG-CAMFLTR 

DIAG-CAMINIT 

DIAG-CAMSID 

DIAG-CAMSTAT 

DIAG-CANTXMIT 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide 
more  information. 

See  also 

centralMemoryTest 

cmemRetentionTest 

cmiTest 

cross PortTest 

itemList 

portLoopbackTest 

portRegTest 

spinSilk 

sramRetentionTest 
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centra  iMemoryTest 


Tests  ASIC-pair  central  memory  operation. 


Synopsis 

centralmemorytest  [--slot  slotnumber]  [-passcnt  count] [-datatype 
type] [-ports  itemlist]  [-seed  value] 

Availability 


Description 

Use  this  command  to  execute  an  address  and  data  bus  verification  of  the  ASIC  SRAMs  that  serve  as  the 
central  memory. 


NOTE:   This  command  cannot  be  executed  on  an  enabled  sv/itch.  You  must  first  disable  the  sv/itch  using 


the  switchDisable  command. 


The  test  consists  of  six  subtests,  each  described  next. 
Built-in  self-repair  subtest 

The  built-in  self-repair  subtest  executes  the  built-in  self-repair  (BISR)  circuitry  in  each  ASIC.  The  BISR 
executes  its  ov/n  BIST,  and  cells  found  to  be  bad  are  replaced  by  redundant  rov/s  provided  in  each  SRAM 
in  the  ASIC.  Once  the  cells  are  replaced,  the  BIST  is  executed  again. 

The  firmware  sets  up  the  hardware  for  the  BISR/BIST  operation  and  checks  the  results.  If  the  done  bit  in 
each  SRAM  is  not  set  within  a  time-out  period,  it  reports  the  DIAG-CMBISRTO.  If  any  of  the  SRAMs  within 
the  ASIC  fails  to  map  out  the  bad  rows,  its  fail  bit  is  set  and  the  DIAG-CMBISRF  error  generated. 

Data  read/write  subtest 

The  data  write/ read  subtest  executes  the  address  and  data  bus  verifications  by  running  a  specified  unique 
ramp  pattern  D  to  all  SRAMs  in  all  ASICs  in  the  switch.  When  all  SRAMs  are  written  with  pattern  D,  the 
SRAMs  are  read  and  compared  against  the  data  previously  written.  This  procedure  is  repeated  with  the 
complemented  pattern  ~D  to  ensure  that  each  data  bit  is  toggled  during  the  test. 

The  default  pattern  used  (by  POST  also)  is  a  QUAD_RAMP  with  a  seed  value  of  0. 
ASIC-to-ASIC  connection  subtest 


["25^  NOTE:   This  subtest  is  not  available  on  2  Gb/s-capable  switches. 


The  ASIC-to-ASIC  connection  subtest  verifies  that  any  port  can  read  the  data  from  any  of  the  ASICs  in  the 
switch,  thus  verifying  both  the  logic  transmitting  and  receiving  the  data  and  the  physical  transmit  data 
paths  on  the  main  board  connecting  all  the  ASICs  to  each  other. 

The  test  method  is  as  follows: 

1.  Fill  the  central  memory  of  all  ASICs  with  unique  frames. 

2.  Set  up  the  hardware  such  that  each  ASIC  is  read  by  all  of  the  ports  in  the  switch.  Data  received  is 
compared  against  the  frame  written  into  the  ASIC. 

•    Port  0  reads  the  central  memory  in  ASIC  0. 


admin 
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Port  1  reads  the  central  memory  in  ASIC  0. 
Port  14  reads  the  central  memory  in  ASIC  0. 
Port  15  reads  the  central  memory  in  ASIC  0. 
Port  0  reads  the  central  memory  in  ASIC  1 . 
Port  1  reads  the  central  memory  in  ASIC  1 . 
Port  14  reads  the  central  memory  in  ASIC  1 . 
Port  15  reads  the  central  memory  in  ASIC  1 . 
Port  15  reads  the  central  memory  in  ASIC  2. 
Port  15  reads  the  central  memory  in  ASIC  3. 

3.  Repeat  step  1  and  step  2  for  the  complemented  pattern. 

4.  Repeat  this  procedure  for  each  ASIC  pair  in  the  blade  under  test. 

The  pattern  used  is  generated  similarly  as  in  data  read/write  subtest  except  that  only  2112  bytes  are 
generated. 

Parity  error  subtest 

The  forced  bad  parity  error  subtest  verifies  that  a  bad  parity  can  be  detected,  its  error  flag  set,  and 
interrupt  bits  set. 

The  test  method  is  as  follows: 

1 .  Clear  the  error  and  interrupt  bits  of  all  ASICs. 

2.  Write  64  bytes  with  bad  parity  to  all  ASICs  at  offset  0. 

3.  Read  each  of  the  ASIC  pairs  at  offset  0  and  check  that  the  error  and  interrupt  bits  are  set. 

4.  Repeat  steps  1  through  3  for  offset  1  through  10. 

Buffer  number  error  subtest 

The  forced  bad  buffer  number  error  subtest  verifies  that  the  bad  buffer  number  in  the  data  packet  can  be 
detected  and  its  error  flag  and  interrupt  bits  set. 

The  test  method  is  as  follows: 

1 .  Clear  the  error  and  interrupt  bits  of  all  ASICs. 

2.  Set  up  the  hardware  so  that  transmission  of  data  includes  a  bad  buffer. 

3.  For  each  of  the  1 1  possible  offsets  for  each  ASIC  X  in  the  switch: 

a.  Write  a  64-byte  pattern  in  the  central  memory. 

b.  Read  X  from  all  ASIC  Y  in  the  switch. 

c.  For  ASIC  X,  ensure: 

•  interrupt  status  bits  set. 

•  the  error  type  is  buffer  number  error. 

•  the  port  number  in  error  is  the  receiver  port  (which  is  the  base  port  of  ASIC  Y). 

d.  Check  that  all  ASICs  besides  X  are  not  interrupted  or  flagged  with  an  error. 
Reading  the  error  register  clears  the  CMEM  interrupt  bit,  preparing  for  the  next  offset  to  test. 
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Chip  number  error  subtest 

The  forced  bad  chip  number  error  subtest  verifies  that  the  bad  buffer  number  in  the  data  packet  can  be 
detected  and  its  error  flag  and  interrupt  bits  set. 

The  test  method  is  as  follows: 

1 .  Clear  the  error  and  interrupt  bits  of  all  ASICs. 

2.  Set  up  the  hardware  so  that  transmission  of  data  includes  a  bad  buffer. 

3.  For  each  of  the  1 1  possible  offsets  for  each  ASIC  X  in  the  switch: 

a.  Write  a  64-byte  pattern  in  the  central  memory. 

b.  Read  X  from  all  ASIC  Y  in  the  switch. 

c.  For  all  ASIC  Y,  ensure: 

•  interrupt  status  bits  set. 

•  the  error  type  is  chip  number  error. 

•  the  port  number  in  error  is  the  receiver  port  (which  is  the  base  port  of  ASIC  Y). 
Reading  the  error  register  clears  the  CMEM  interrupt  bit,  preparing  for  the  next  offset  to  test. 

Operands 

This  command  has  the  following  operands: 

--slot  slotnumber     Specify  the  slot  number  on  which  the  diagnostic  will  operate. 

The  ports  specified  will  be  relative  to  this  slot  number.  The 
default  is  set  to  0  and  designed  to  operate  on  fixed  port-count 
products. 

-passcnt  count  Specify  the  number  of  test  passes  to  run.  By  default,  the  test  runs 

one  time. 

-datatype  type  Specify  the  type  of  data  pattern  to  use.  By  default,  type  9, 

QUAD  RAMP,  is  used.  For  a  complete  list  of  supported  data 
patterns,  run  the  dataTypeShow  command.  Some  common 
settings  are: 

1  BYTE_FILL  pattern 

2  WORD_FILL  pattern 

3  QUAD_FILL  pattern 

9  QUAD_RAMP  (Addr=Data)  pattern 

1 1         RANDOM  pattern 

-ports  2  temlist         Specify  a  list  of  blade  ports  to  test.  The  Ports  list  is  translated  into 

a  matching  Quad  list  before  the  test  is  run.  By  default,  all  the 
blade  ports  in  the  specified  slot  (--slot)  are  tested.  Refer  to 
ItemList  for  more  information. 

-seed  value  Specify  the  data  pattern  seed  to  be  used.  The  default  seed  value 

is  0. 
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Examples 

To  test  the  ASIC  central  memory: 


switch : admin>  centralmemorytest  -ports  1/0-1/15 

Running  centralmemorytest   

Test  Complete:    "centralmemorytest"  Pass  1  of  1 
Duration  0  hr,    0  min  &  5  sec  (0:0:5:412). 
passed. 

Diagnostics 

When  this  command  detects  failure(s),  each  subtest  can  report  one  or  more  of  the  following  error 
messages: 

Subtest  2 

LCMEM_ERR 
LCMRS_ERR 
LCMTO_ERR 

Subtest  3 

CM_NO_BUF 
LCMEMTX_ERR 
LCMRS_ERR 
LCMTO_ERR 

Subtest  4 

BAD_INT 
CM_ERR_PTN 
CM_ERR_TYPE 
TIMEOUT 

Subtest  5 

BAD_INT 
CM_ERR_PTN 
CM_ERR_TYPE 
TIMEOUT 

Subtest  6 

BAD_INT 
CM_ERR_PTN 
CM_ERR_TYPE 
TIMEOUT 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

camTest 

cmemRetentionTest 
cmiTest 
crossPortTest 
itemList 
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portLoopbackTest 

portRegTest 

spinSilk 

sramRetentionTest 
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cfgActvShow 

Displays  current  zone  configuration  information. 

Synopsis 

cf gactvshow 

Availability 

all  users 


\^^}f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  display  the  effective  zone  configuration  information. 

The  current  configuration  is  a  single  zone  configuration  that  is  currently  in  effect.  The  devices  that  an 
initiator  sees  are  based  on  this  configuration.  The  effective  configuration  is  built  when  a  specified  zone 
configuration  is  enabled. 


NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  PCS  sv/itch. 


Operands 

none 

Examples 

To  display  the  effective  zone  configuration  information: 


switch :  ac3inin> 

cf gactvshow 

Effective 

configuration : 

cf  g : 

c4 

zone : 

z3 

33:07:06 

05 

04 

03 

02 

01 

zone : 

z4 

44:01:23 

45 

67 

89 

aO 

be 

40:01:23 

45 

67 

89 

aO 

be 

See  also 

cf gClear 
cf gDelete 
cf gRemove 
cf gSave 
cf gShow 
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cfgAdd 

Adds  a  member  to  a  zone  configuration. 

Synopsis 

cfgadd  "cfgName",   "member;  member" 

Availability 

admin 


l^if  NOTE:    This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  add  one  or  more  members  to  an  existing  zone. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  in  effect,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 


NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  sv/i 

Operands 

This  command  has  the  follov/ing  required  operands: 

cfgName  Specifies  a  name  for  the  zone  configuration,  in  quotation  marks. 

member  Specifies  a  zone  member  or  list  of  zone  members  to  be  added  to 

the  configuration,  in  quotation  marks  and  separated  by 
semicolons.  Members  can  be  specified  in  one  or  more  of  the 
following  ways: 

•  Zone  names 

•  QuickLoop  names 

•  FA  (Fabric  Assist)  zone  names 

Examples 

To  add  two  new  zones  to  the  configuration  "Test_cfg": 

switch : admin>  cfgadd  "Test_cfg",    "redzone;  bluezone" 

See  also 

cf gClear 
cf gCreate 
cf gDelete 
cf gDisable 


tch. 
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cf gEnable 
cf gRemove 
cf gSave 
cf gShow 
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cfgClear 

Clears  all  zone  configurations. 

Synopsis 


cf gclear 


Availability 

admin 


I^Jf  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  clear  all  zone  information  in  the  transaction  buffer.  All  defined  zone  objects  in  the 
transaction  buffer  are  deleted.  If  an  attempt  is  made  to  commit  the  empty  transaction  buffer  while  a  zone 
configuration  is  enabled,  you  are  warned  to  first  disable  the  enabled  zone  configuration  or  to  provide  a 
valid  configuration  with  the  same  name. 

After  clearing  the  transaction  buffer  using  the  cfgClear  command,  use  the  cf gDisable  command  to 
commit  the  transaction  and  then  disable  and  clear  the  zone  configuration  in  flash  memory  for  all  the 
switches  in  the  fabric. 


If  no  current  zoning  configuration  exists,  use  the  cfgSave  command. 


I^Jf  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  PCS  switch. 


Operands 

none 

Examples 

To  clear  all  zones  and  then  clear  flash  memory: 

switch : admin>  cf gclear 
switch : adinin>  cfgsave 

See  also 

cf gDisable 
cf gEnable 
cf gSave 
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cfgCreate 

Creates  a  zone  configuration. 

Synopsis 


cfgcreate  " cfgName" ,   "member;  member" 


Availability 

admin 


1^)f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  create  a  new  zone  configuration. 

A  zone  configuration  name  must  begin  with  a  letter  that  can  be  followed  by  any  number  of  letters, 
numbers,  and  underscores.  Names  are  case  sensitive:  for  example,  "Cfg_l  "  and  "cfg_l  "  are  different 
zone  configurations.  Blank  spaces  are  ignored. 

The  zone  configuration  member  list  must  have  at  least  one  member.  Empty  member  lists  are  not  allowed. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

Refer  to  the  zoneCreate  command  for  more  information  on  name  and  member  specifications. 
"22^  NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  required  operands: 

cfgName  Specify  a  name  for  the  zone  configuration,  in  quotation  marks. 

member  Specify  a  zone  member  or  list  of  zone  members  to  be  added  to 

the  configuration,  in  quotation  marks  and  separated  by 
semicolons.  Members  can  be  specified  in  one  or  more  of  the 
following  ways: 

•  Zone  names 

•  QuickLoop  names 

•  FA  (Fabric  Assist)  zone  names 

Examples 

To  create  a  configuration  containing  three  zones: 

switch : admin>  cfgcreate  "USA_cfg",    "Red_zone;  Blue_zone;  Green_zone" 
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See  also 

cf gAdd 
cf gClear 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cf gShow 
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cfg  Delete 

Deletes  a  zone  configuration. 

Synopsis 


cfgdelete  " cfgName" 


Availability 

admin 


1^)f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  delete  a  zone  configuration. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  in  effect,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cf  gEnable  command. 

NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  sv/itch. 

Operands 

This  command  has  the  follov/ing  operand: 

cfgName  Specify  a  name  for  the  zone  configuration  to  be  deleted,  in 

quotation  marks.  This  operand  is  required. 

Examples 

To  delete  a  zone  configuration: 

switch : admin>  cfgdelete  "USA_cfg" 

See  also 

cfgAdd 
cf gClear 
cf gCreate 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cf gShow 
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cfgDisable 


Disables  a  zone  configuration. 


Synopsis 

cf gdisable 

Availability 

admin 


\^^}f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Use  this  command  to  disable  the  current  zone  configuration.  The  fabric  returns  to  nonzoning  mode,  in 
which  all  devices  see  each  other. 

This  command  ends  and  commits  the  current  zoning  transaction  buffer  to  both  volatile  and  flash  memory. 
If  a  transaction  is  open  on  a  different  switch  in  the  fabric  when  this  command  is  run,  the  transaction  on  the 
other  switch  is  automatically  aborted.  A  message  is  displayed  on  the  other  switches  to  indicate  the 
aborting  of  the  transaction. 


NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  PCS  switch. 


Description 


Operands 


none 


Examples 


To  disable  the  current  zone  configuration: 


switch :  adinin>  cf  gdisable 


See  also 


cf gClear 


cf gEnable 


cf gSave 
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cfg  Enable 

Enables  a  zone  configuration. 

Synopsis 


cfgenable " cfgName" 


Availability 

admin 


1^)f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  enable  a  zone  configuration.  The  specified  zone  configuration  is  built  by  checking 
for  undefined  zone  names,  zone  alias  names,  or  other  inconsistencies  by  expanding  zone  aliases, 
removing  duplicate  entries,  and  then  installing  the  current  configuration. 

If  the  build  fails,  the  previous  state  is  preserved  (zoning  remains  disabled,  or  the  previous  configuration 
remains  in  effect).  If  the  build  succeeds,  the  new  configuration  replaces  the  previous  configuration.  Refer  to 
the  cfgShow  command  for  a  description  of  defined  and  current  configurations. 

NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  PCS  sv/itch. 

Operands 

This  command  has  the  following  operand: 

cfgName  Specify  the  name  of  a  zone  configuration  to  enable,  in  quotation 

marks.  This  operand  is  required. 

Examples 

To  enable  the  zone  configuration  "Test_cfg": 

switch : admin>  cfgenable  "USA_cfg" 
zone  config  "USA_cfg"   is  in  effect 

See  also 

cf gClear 
cf gDisable 
cf gSave 
cf gShow 
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cfg  Remove 

Removes  a  member  from  a  zone  configuration. 

Synopsis 

cfgremove  "cfgName",   "member  [/  member  ...]' 

Availability 

admin 


l^if  NOTE:    This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  remove  one  or  more  members  from  an  existing  zone  configuration. 
If  all  members  are  removed,  the  zone  configuration  is  deleted. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  in  effect,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

I^Jf  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

The  following  operands  are  required: 

cfgName  Specify  a  name  for  the  zone  configuration,  in  quotation  marks. 

member  Specify  a  zone  member  or  list  of  zone  members  to  be  added  to 

the  configuration,  in  quotation  marks  and  separated  by 
semicolons.  Members  can  be  specified  in  one  or  more  of  the 
following  ways: 

•  Zone  names 

•  QuickLoop  names 

•  FA  (Fabric  Assist)  zone  names 

Examples 

To  remove  a  zone  from  a  configuration: 

switch : adinin>  cfgremove  "Test_cfg" ,  "redzone" 

See  also 

cf gAdd 
cf gClear 
cf gCreate 
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cf gDelete 

cf gDisable 

cf gEnable 

cf gSave 

cf gShow 

c  fgTrans Abort 

cf gTransShow 
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cfgSave 

Saves  zone  configuration  to  flash  memory. 

Synopsis 

cf gsave 

Availability 

admin 


l^if  NOTE:    This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  save  the  current  zone  configuration.  The  defined  configuration  and  the  name  of  the 
enabled  configuration  are  v/ritten  to  flash  memory  in  all  sv/itches  in  the  fabric. 

The  saved  configuration  is  automatically  reloaded  by  the  switch  on  power  on  and,  if  a  configuration  was 
in  effect  at  the  time  it  was  saved,  the  same  configuration  is  reinstalled  with  an  automatic  cf  gEnable 
command. 

Because  the  saved  configuration  is  reloaded  at  power  on,  only  valid  configurations  are  saved.  cfgSave 
verifies  that  the  enabled  configuration  is  valid  by  performing  the  same  tests  as  cfgEnable.  If  the  tests 
fail,  an  error  is  displayed  and  the  configuration  is  not  saved.  Tests  might  fail  if  a  configuration  has  been 
modified  since  the  last  cfgEnable. 

This  command  ends  and  commits  the  current  transaction.  If  a  transaction  is  open  on  a  different  switch  in 
the  fabric  when  this  command  is  run,  the  transaction  on  the  other  switch  is  automatically  aborted.  A 
message  is  displayed  on  the  other  switches  to  indicate  the  aborting  of  the  transaction. 

NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  PCS  switch. 
Operands 

none 

Examples 

To  save  a  zone  configuration: 

switch : admin>  cf gsave 
Updating  flash. . . 

See  also 

cfgAdd 
cf gClear 
cf gCreate 
cf gDelete 
cf gDisable 
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cf gEnable 
cf gRemove 
cf gShow 
c  fgTrans Abort 
cf gTransShow 
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cfgShow 

Displays  zone  configuration  information. 

Synopsis 

cfgshow   ["pattern"]  [,  mode] 

Availability 

all  users 


I^Jf  NOTE:    This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  display  zone  configuration  information. 

If  no  operand  is  specified,  all  zone  configuration  information  (both  defined  and  effective)  displays. 

If  an  operand  is  specified,  it  is  used  as  a  pattern  to  match  zone  configuration  names  in  the  defined 
configuration;  those  that  match  the  pattern  displays. 

The  defined  configuration  is  the  complete  set  of  all  zone  objects  that  have  been  defined  in  the  fabric. 
There  can  be  multiple  zone  configurations  defined,  but  only  one  can  be  enabled  at  a  time.  There  might  be 
inconsistencies  in  the  definitions,  zones,  or  aliases  that  are  referenced  but  not  defined,  or  there  might  be 
duplicate  members.  The  defined  configuration  is  the  current  state  of  the  administrator  input. 

The  effective  configuration  is  the  single  zone  configuration  that  is  currently  enabled.  The  devices  that  an 
initiator  sees  in  the  fabric  are  based  on  this  configuration.  The  effective  configuration  is  built  v/hen  a 
specific  zone  configuration  is  enabled  and  all  error  checking  has  been  completed  successfully. 

'25^  NOTE:   When  security  is  enabled,  this  command  can  be  issued  on  any  PCS  sv/itch  in  the  fabric. 


Operands 

This  command  has  the  follov/ing  optional  operands: 

pattern  A  POSIX-style  regular  expression  used  to  match  zone 

configuration  names.  The  pattern  must  be  enclosed  in  quotation 
marks,  and  can  contain: 

•  Question  mark  (?),  which  is  a  placeholder  for  any  single 
character 

•  Asterisk  (*),  which  is  a  placeholder  for  any  string  of 
characters 

•  Ranges,  which  are  a  placeholder  for  any  character  within  the 
range.  Ranges  must  be  enclosed  in  brackets:  for  example, 

[0-9]  or  [a-f]. 

mode  Specify  0  to  display  the  contents  of  the  transaction  buffer  (the 

contents  of  the  current  transaction)  or  specify  1  to  display  the 
contents  of  flash  memory.  The  default  value  is  0. 
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Examples 

To  display  all  zone  configurations  that  start  with  "Test": 


switch : admin>  cfgshow  "Test*" 

cfg:       Testl  Blue_zone 

cfg:       Test_cfg  Red_zone;  Blue_zone 


To  display  all  zone  configuration  information: 


switch : admin>  cfgshow 
Defined  configuration: 
cfg:       USAl  Blue_zone 
cfg:       USA_cfg  Red_zone;  Blue_zone 
zone:  Blue_zone 

1,1;   arrayl ;   1,2;  array2 
zone:  Red_zone 
1,0;  loopl 

alias:  arrayl  21 : 00 : 00 : 2 0 : 37 : Oc : 76 : 8c ;  21 : 00 : 00 : 20 : 37 : Oc : 71 : 02 
alias:  array2  21 : 00 : 00  :  20 : 37  :  Oc : 76 : 22 ;  21 : 00 : 00 : 20 : 37 : Oc : 76 : 28 
alias:    loopl        21 : 00 : 00 : 20 : 37 : Oc : 76 : 85 ;    2 1 : 0 0 : 0 0 : 2 0 : 3 7 : Oc : 7 1 : df 

Effective  configuration: 
cfg:  USA_cfg 
zone:  Blue_zone 
1, 1 

21:00:00:20:37:0c:76:8c 
21:00:00:20:37:0c:71:02 
1,2 

21:00:00:20:37:0c:76:22 
21:00:00:20:37:0c:76:28 
zone:  Red_zone 
1,  0 

21:00:00:20:37:0c:76:85 
21:00:00:20:37:0c:71:df 


To  display  only  configuration  names: 


switch : admin>  cfgshow  "*" 

cfg:       USAl  Blue_zone 

cfg:       USA_cfg  Red_zone;  Blue_zone 


See  also 

cfgAdd 
cf gClear 
cf gCreate 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
c  fgTrans Abort 
cf gTransShow 
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cfgSize 

Displays  zone  database  size  details. 

Synopsis 


cfgsize  [integer] 


Availability 

all  users 


I^Jf  NOTE:    This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  display  the  size  details  of  the  zone  database.  All  sizes  are  in  bytes. 

The  size  details  include  the  following: 

Zone  DB  max  size  The  upper  limit  for  the  defined  configuration,  determined  by  the 

amount  of  flash  memory  available  for  storing  the  defined 
configuration 

Transaction  size  The  size  of  the  uncommitted  defined  configuration.  This  value  will 

be  nonzero  if  the  defined  configuration  is  being  modified  by 
telnet,  API,  and  so  forth;  otherwise  it  is  0 

Committed  size  The  size  of  the  defined  configuration  currently  stored  in  flash 

Refer  to  cf  gShow  for  a  description  of  defined  and  effective  configurations. 

NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  PCS  switch. 


Operands 

This  command  has  the  following  optional  operand: 

integer  If  a  nonzero  integer  is  specified  as  the  parameter,  the  size  of  the 

flash  memory  allocated  for  the  zone  database  is  displayed.  The 
zone  database  includes  both  the  defined  and  effective 
configurations.  This  size  is  in  kilobytes. 

Examples 

To  display  size  details  of  the  defined  configuration: 

switch : admin>  cfgsize 

Zone  DB  max  size  -  127726  bytes 

committed  -  8812 

transaction  -  0 

switch : admin>  cfgsize  1 

Zone  DB  flash  size  -  131028  bytes 

See  also 

cf gShow 
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cfgTrans  Abort 

Aborts  the  current  zoning  transaction. 

Synopsis 

cf gtransabort  [token] 

Availability 

admin 


"2^2jf  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  abort  the  current  zoning  transaction  without  committing  it.  All  changes  made  since 
the  transaction  was  started  will  be  removed  and  the  zone  configuration  database  restored  to  the  state 
before  the  transaction  was  started. 

If  a  transaction  is  open  on  a  different  switch  in  the  fabric  when  this  command  is  run,  the  transaction  on  the 
other  switch  remains  open  and  unaffected. 

1^)f  NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  PCS  switch. 


Operands 

This  command  has  the  following  operand: 

token  Specify  the  token  ID  of  an  abortable  transaction.  Use  the 

cf  gTransShow  command  to  obtain  the  token  ID  of  a  transaction. 

Examples 

To  abort  the  current  transaction: 

switch :  ac3inin>  cf  gtransabort 

See  also 

cfgAdd 
cf gClear 
cf gCreate 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cf gShow 
cf gTransShow 
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cfgTransShow 

Displays  information  about  the  current  zoning  transaction. 

Synopsis 

cf gtransshow 

Availability 

all  users 


\^^}f  NOTE:    This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  display  the  ID  of  the  current  zoning  transaction.  This  command  also  gives  information 
about  whether  or  not  a  transaction  can  be  aborted  or  not.  The  transaction  cannot  be  aborted  if  it  is  an 
internal  zoning  transaction. 


\^^)f  NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  PCS  sv/itch. 


Operands 

none 

Examples 

To  display  the  current  transaction: 


switch :  adinin>  cf  gtransshow 

There  is  no  outstanding  zone  transactions 

switch : adinin>  cfgclear 

Do  you  really  want  to  clear  all  configurations? 

(yes,  y,  no,   n) : 

[no]  y 

Clearing  All  zoning  configurations... 

switch : admin>  cf gtransshow 

Current  transaction  token  is  271010736 

It  is  abortable 

See  also 

cfgAdd 
cf gClear 
cf gCreate 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
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cf gSave 
cf gShow 
c  fgTrans Abort 
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chassisConfig 


Displays  or  sets  the  configuration  of  the  chassis. 

Synopsis 

chassisconf ig  [   -f  ]    [   option  ] 

Availability 

admin  (set) 

all  users  (display) 
Description 

Use  this  command  to  set  the  chassis  configuration  for  products  that  support  both  single-switch  and 
dual-switch  operation.  Each  configuration  specifies  whether  the  chassis  runs  as  one  logical  switch  or  two; 
and  the  port  blade  ID  that  is  permitted  on  each  logical  switch.  Any  port  blade  ID  that  does  not  match  the 
current  configuration  is  considered  incompatible,  and  does  not  be  powered  up. 

When  no  arguments  are  provided,  this  command  displays  the  current  configuration  of  the  chassis  as  well 
as  a  list  of  the  supported  configurations.  When  a  specific  option  is  provided  to  this  command,  all  CPs 
currently  in  the  system  are  immediately  rebooted,  returning  in  the  mode  that  the  user  has  specified.  This 
can  result  in  some  blades  being  faulted  as  incompatible,  based  on  the  new  configuration  option.  This 
command  rejects  without  causing  a  reboot,  if  an  option  is  not  supported  by  the  platform.  See  the 
Operands  section  for  supported  options 

Use  the  slotshow  command  to  display  the  current  set  of  blades  in  the  system. 

When  the  system  changes  from  single  to  multiple  domains  and  vice  versa,  configuration  parameters  that 
are  not  compatible  are  restored  to  factory  defaults.  The  configuration  data  includes,  but  not  limited  to 
routing,  port  swap,  fabric,  zoning,  port  configuration,  passwords,  security,  HP  Fabric  Watch,  management 
server,  time  server,  SNMP,  performance  monitoring,  and  general  HP  Fabric  OS  configuration  values.  It  is 
recommended  that  the  current  configuration  be  saved  using  conf  igUpload  as  a  guide  for  adjustments 
after  the  configuration  change. 

Certain  configuration  values  that  are  not  considered  switch  based  and  determined  not  to  cause  adverse 
effects  are  left  untouched  for  user  convenience.  These  include  SSL  certificates,  PKI  certificates,  licenses,  and 
IP  address. 

When  the  -f  (force)  option  is  omitted,  this  command  prompts  for  user  consent  to  proceed  further  with  the 
configuration  change.  It  also  prompts  the  user  to  upload  the  configuration  data  to  a  host  so  it  can  be  used 
as  a  guide  to  re-establishing  the  configuration  data  in  the  new  mode.  Use  the  -f  option  to  proceed  without 
the  interactive  step. 

Unless  the  chassis  is  currently  configured  as  Option  1  (a  single  1  28-port  switch  with  SW  blade  IDs  4  and 
CP  blade  IDs  5),  both  CP  blades  should  always  contain  firmware  that  supports  this  command.  Use  of 
earlier  versions  will  adversely  affect  switch  operation. 

Because  this  is  a  disruptive  operation  and  has  profound  effect  on  the  behavior  of  the  chassis,  it  needs  to 
be  used  selectively. 

Users  running  secure  mode  should  be  particularly  careful  in  using  this  command  to  change  the  number  of 
domains  on  the  local  chassis,  because  security  is  disabled  on  all  resulting  local  switches.  These  switches 
are  not  able  to  participate  in  a  secure  fabric  until  secure  mode  is  restored.  Therefore,  the  fabric  should 
have  a  primary  FCS  outside  this  chassis,  to  manage  security  throughout  the  fabric  during  this  transition. 


Fabric  OS  5.0.0  command  reference  guide  97 


Operands 

The  operands  are  as  follows: 

-f  If  specified,  forces  configuration  changes  without  asking  for  confirmation  or 

requesting  a  configuration  upload. 

option  Specify  the  new  configuration  option  to  apply  to  the  chassis.  This  operand  is 

optional;  if  omitted,  this  command  displays  the  current  configuration  option, 
and  a  list  of  all  valid  options.  Values  include: 

1  One  1  28-port  switch  (blade  ID  4  on  slots  1  through  4  and  7 

through  10) 


Examples 


2 
3 


Two  64-port  switches  (blade  ID  4  on  slots  1  through  4  and  7 
through  10) 


Two  64-port  switches  (blade  ID  4  on  slots  1  through  4,  ID  2  on  slots  7 
through  10) 

Two  64-port  switches  (blade  ID  2  on  slots  1  through  4,  ID  4  on  slots  7 
through  10) 


switch : admin>  chassisconf ig  2 


This  will  reboot  all  the  CPs  and  the  configuration  data  will  be  restored 
to 

factory  defaults  if  moved  between  single  and  multiple  domains.  This 
includes , 

but  are  not  limited  to,   port  swap,   routing,    zoning,  performance 
monitoring,  port 

config,    fabric  watch,  management  server,   time  server,   snmp,  security, 
fabric  and 

other  FabOs  configuration  parameters . 


Traffic  will  be  disrupted  and  both  the  CPs  comes  up  and  will  vary  in  the 
number 

of  switches  and  the  Blade  IDs  they  recognize  based  on  the  configuration 

selected.  Some  configuration  values  are  applicable  to  both  single-domain 
and 

multiple-domain  switches,   and  are  therefore  not  modified.  (Examples: 
licenses , 

IP  addresses,  host  and  switch  names,   SSL  certificates,  PKI 
certificates.)  Please 

read  the  man  page  for  further  information. 


(continued  on  next  page) 
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See  also 


Please  upload  switch  0  configuration. . . 

Server  Name  or  IP  Address    [host]:  192.168.79.240 

User  Name  [user]  :  clconchad 

File  Name   [config.txt] : 

Password: 

Upload  complete 

Are  you  sure  you  want  to  continue?    (Y/N) :  y 

Current  Option  changed  to  2 

Restoring  switch  0  configuration  to  factory  defaults.. 

.  done . 

(Telnet  connection  goes  down  at  this  point.) 

conf igDownload 

conf igUpload 

slotSliow 

Fabric  OS  5.0.0  command  reference  guide  99 


chassisName 


Displays  or  sets  the  chassis  name  for  a  switch. 

Synopsis 

chassisname  [name] 

Availability 

admin  (set) 

all  users  (display) 
Description 

Use  this  command  to  change  the  name  associated  with  the  chassis.  In  the  Core  Switch  2/64  and  SAN 
Director  2/1  28,  there  are  two  logical  switches  associated  with  a  single  chassis. 

Enter  this  command  with  no  parameter  to  display  the  current  name. 

Enter  this  command  with  a  name  operand  to  set  the  chassis  name. 

Operands 

This  command  has  the  following  operand: 

nomeSpecifies  a  new  name  for  the  chassis.  Chassis  names  can  be  up  to  15  characters  long  and  must 
begin  with  a  letter.  The  name  must  consist  of  letters,  digits,  or  underscore  characters  and  no  spaces. 

Examples 

To  change  the  chassis  name  to  "dilbert": 

switch : admin>  chassisname  dilbert 

Please  wait  while  committing  configuration. . . 

switch : admin>  chassisname 

dilbert 


See  also 


switchName 
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chassisShow 

Displays  all  field  replaceable  units  (FRUs). 

Synopsis 

chassisshow 

Availability 

all  users 

Description 

Use  this  command  to  inventory  and  display  the  FRU  header  content  for  each  object  in  the  chassis. 

The  header  data  is  formatted  into  a  record  consisting  of  up  to  13  lines.  Refer  to  Table  5  for  more 
information  about  the  lines  and  their  meaning. 


Table  5    Command  output  descriptions 


Line 

Description 

1 

Object  type:  CHASSIS,  FAN,  POWER  SUPPLY,  SW  BLADE  (switch),  CP  BLADE 
(control  processor),  WWN  (World  Wide  Name),  or  UNKNOWN. 

Object  number:  Slot  nn  (for  blades).  Unit  nn  (for  everything  else). 

If  the  FRU  is  part  of  an  assembly,  a  brief  description,  in  parenthesis,  displays. 

2 

FRU  header  version  number:  Header  Version:  x 

3 

Value  to  calculate  the  object's  power  consumption:  positive  for  power  supplies  and 
negative  for  consumers.  Power  Consume  Factor:  -xxx 

4 

Part  number  (up  to  14  characters):  Factory  Part  Num:  xx-xxxxxx-xx 

5 

Serial  number  (up  to  1  2  characters):  Factory  Serial  Num:  xxxxxxxxxx 

6 

FRU  manufacture  date:  Manufacture  :  Day :   dd  Month:   mm  Year:  yyyy 

7 

Date  of  the  last  FRU  header  update:  Update :  Day:   dd  Month:  mm  Year: 

yyyy 

8 

Cumulative  time,  in  days,  that  the  FRU  has  been  powered  on:  Time  Alive :  dddd 
days 

9 

Current  time,  in  days,  since  the  FRU  was  last  powered  on:  Time  Awake:  ddd  days 

10 

Externally  supplied  ID  (up  to  10  characters):  ID:  xxxxxxxxxx 

11 

Externally  supplied  part  number  (up  to  20  characters): 

Part  Num:  xxxxxxxxxxxxxxxxxxxx 

12 

Externally  supplied  serial  number  (up  to  20  characters): 

Serial  Num: xxxxxxxxxxxxxxxxxxxx 

13 

Externally  supplied  revision  number  (up  to  4  characters):  Revision  Num:  xxxx 

Operands 

none 
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Examples 

To  display  all  FRUs  for  a  switch: 


switch:user>  chassisshow 

SW  BLADE      Slot:  3 

Header  Version: 

1 

Power  Consume  Factor: 

-180 

Factory  Part  Num: 

60-0001532-03 

Factory  Serial  Num: 

1013456800 

Manufacture : 

Day:    12  Month: 

6 

Year : 

2001 

Update : 

Day:    15  Month: 

7 

Year : 

2001 

Time  Alive: 

2  8  days 

Time  Awake : 

1 6  days 

ID : 

555-374757 

Part  Num: 

234-294-12345 

Serial  Num: 

2734658 

Revision  Num: 

A.  00 

CP  BLADE      Slot:  6 

Header  Version: 

1 

Power  Consume  Factor: 

-40 

Factory  Part  Num: 

60-0001604-02 

Factory  Serial  Num: 

FPO0X6O0128 

Manufacture : 

Day:   12  Month: 

6 

Year : 

2001 

Update : 

Day:   15  Month: 

7 

Year : 

2001 

Time  Alive: 

6 1  days 

Time  Awake : 

1 6  days 

ID : 

555-374757 

Part  Num: 

236-296-12350 

Serial  Num: 

2836542 

Revision  Num: 

A.  00 

POWER  SUPPLY     Unit:  2 

Header  Version: 

1 

Power  Consume  Factor: 

1000 

Factory  Part  Num: 

60-0001536-02 

Factory  Serial  Num: 

A013450700 

Manufacture : 

Day:    14  Month: 

6 

Year : 

2001 

Update : 

Day:    15  Month: 

7 

Year : 

2001 

Time  Alive: 

5  0  days 

Time  Awake : 

1 6  days 

ID: 

555-374757 

Part  Num: 

238-298-12360 

Serial  Num: 

1234567 

(continued  on  next  page) 
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ir  i-U.M       u  n  1  C  .  ± 

rit;c±U.t=i    v  t=-L  b  -L  Uii  . 

1 

X 

irUWtiX     L-UIlo  U-lLLt:    r         LUX  . 

-  R  n 

TP  ^      ^      "K'T  7"     "D     V"  "H     IVTi  i  m  ■ 

r  dC-  UUi  Y    JrdX  U    IN  U.ILL . 

90-1  97A'=;^^-1  9 

XT'  ^     -1—           7"     C     -V"  n  ^  1      TVTi  1  m  ■ 
rcH—LUXy    ofc=XJ.a.-L    IM  UlLl . 

i^IdliU.  J-  CiC  L  U.-L  . 

udy .      o  i'luiiuii. 

7 
1 

Year : 

9  n  n  1 

Z  U  U  -L 

TTv^i--^  =3  -1-  ■ 

upQdue . 

jJdy  .    -L  D     rioncn  . 

7 
1 

Year : 

9  n  n  1 

z  U  U  -L 

Txitis  AlivG: 

o  o  Qay s 

Tims  Aw9.ks  : 

16  days 

y:OD      /  /  /OOO 

Part  Num: 

230-290-12370 

Serial  Num: 

3456789 

Revision  Num: 

A.  02 

{ output  truncated) 

See  also 

slotShow 
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chipRegShow 


Displays  the  port  registers  for  a  given  chip  number. 


Synopsis 

chipregshow   [slotnumber/ ] chipnumber  [filter] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  ASIC  pair  register  contents  for  the  specified  chip  on  the  specified  blade 
slot. 


\^^)f  NOTE:    The  output  of  this  command  is  only  for  support  use  only. 


Operands 


This  command  has  the  following  operands: 


filter 


[slotnumber/] chipnumber 


Specifies  the  index  of  the  chip  within  the  specified  blade  to 
display.  The  default  is  set  to  0  and  designed  to  operate  on 
fixed-port-count  products. 

Specifies  a  filter  string. 


Examples 


To  display  the  port  registers  of  a  chip: 


switch : admin>  chipregshow  1/1  ffffffff 


See  also 


minisPropShow 
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cmemRetentionTest 


Tests  the  data  retention  of  the  central  memory  SRAMs. 

Synopsis 

cmemretentiontest   [--slot  slotnumber]  [-passcnt  count] [-datatype 
type] [-ports  itemlist]  [-seed  value] 

Availability 

admin 

Description 

Use  this  command  to  verify  that  data  written  into  the  central  memory  SRAMs  in  the  ASIC  pair  is  retained 
after  a  1 0-second  wait.  The  method  used  is  to  write  a  fill-pattern  to  all  SRAMs,  wait  1 0  seconds,  and  then 
read  all  SRAMs  to  verify  that  the  data  read  matches  the  data  previously  written.  The  process  is  then 
repeated  using  the  reverse  version  of  the  pattern. 

p2^^  NOTE:    This  command  cannot  be  executed  on  an  enabled  switch.  You  must  first  disable  the  switch  using 

the  switcliDisable  command. 


Operands 

This  command  has  the  following  operands: 

--slot  Specify  the  slot  number  on  which  the  diagnostic  will  operate.  The  ports  specified  will 

slotnumber     be  relative  to  this  slot  number.  The  default  is  set  to  0  and  designed  to  operate  on 
fixed-port-count  products. 

Specify  the  number  of  test  passes  to  run.  By  default,  the  test  will  be  run  one  time. 

Specify  the  type  of  data  pattern  to  use.  By  default,  type  9,  QUAD_RAMP,  is  used.  For 
a  complete  list  of  supported  data  patterns,  run  the  dataTypeSliow  command.  Some 
common  settings  are: 

-passcnt 
count 

-datatype 
type 

Pattern  Type  Example 

BYTE_FILL  1  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00 

WORD_FILL  2  0000  0000  0000  0000  0000  0000  0000  0000 

QUAD_FILL  3  00000000     00000000     00000000  00000000 

QUAD_RAMP  9  00000000     00000001     00000002  00000003 

RANDOM  11  55  16fcd7  17  65  a9  87  5f44be5ad0debca5 

-ports  Specifies  a  list  of  blade  ports  to  test.  The  ports  list  is  translated  into  a  matching  quad 

itemlist         list  before  the  test  is  run.  By  default,  all  the  blade  ports  in  the  specified  slot  (--slot) 
are  tested.  Refer  to  the  ItemList  help  pages  for  further  details. 

-seed  Specify  the  data  pattern  seed  to  be  used.  The  default  seed  value  is  0. 

value 
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Examples 

To  run  the  data-retention  test  on  the  central  memory  SRAMS: 


switch :  adiT\in>  cmemretentiontest  - 

--slot  3 

Running  cmemretentiontest   

Test  Complete:  cmemretentiontest 

Pass  2  of  2 

Duration  0  hr,   2  min  &  13  sec  (0 

:2  :13 :234)  . 

passed. 

Diagnostics 

The  following  are  possible  error  messages: 

LCMEM_ERR 
LCMRS_ERR 
LCMTO_ERR 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

camTest 

centralMemoryTest 

cmiTest 

crossPortTest 

dataTypeShow 

itemList 

portLoopbackTest 
spinSilk 

sramRetentionTest 
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cmiTest 

Verifies  the  control  message  interface  (CMI)  bus  between  ASICs. 

Synopsis 

cmitest    [--slot  slotnumber]  [-passcnt  count] [-txports  itemlist]  [-rxports 
itemlist]  [-skip  mask] 

Availability 

admin 

Description 

Use  this  command  to  test: 

•  Multiplexed  4-bit  CMI  point-to-point  connection  between  two  ASICs. 

•  Message  sent  with  a  bad  checksum  sets  the  error  and  interrupt  bits  of  the  destination  ASIC. 

•  Message  sent  with  a  good  checksum  does  not  set  any  error  or  interrupt  bit  in  any  ASIC  pair. 

The  CMI  is  used  to  send  transmission  requests  or  completion  messages  between  the  ASIC  transmitter  and 
receiver. 

Options 

This  command  has  the  following  options: 

--slot  slotnumber      Specifies  the  slot  number  to  test.  The  default  is  set  to  0  and  designed 

to  operate  on  fixed-port-count  products. 

-passcnt  count  Specifies  the  number  of  test  passes  to  run.  By  default,  the  test  runs  one 

time. 

-txports  i  temlist      Specifies  a  list  of  ports  to  transmit  data.  By  default,  all  the  ports  in  the 

specified  slot  (--slot)  are  used.  Refer  to  itemList  help  pages  for 
further  details. 

-rxports  itemlist      Specifies  a  list  of  ports  to  receive  data.  By  default,  all  the  ports  in  the 

specified  slot  (--slot)  are  used.  Refer  to  itemList  for  more 
information. 

-skip  mask  Specifies  tests  to  skip  using  a  bit  map  as  follows: 

1  CMI  data  test  (ignore  checksum) 

2  CMI  checksum  test 

3  Enable  all  tests 

Examples 

To  run  a  CMI  test  between  two  ASIC  pairs: 

switch :admin>  cmitest  -txports  3/0-3/7  -rxports  3/8-3/15 

Running  cmitest   

Test  Complete:  cmitest  Pass  1  of  1 
Duration  0  hr,    0  min  &  2   sec  (0:0:2:591). 
passed. 
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Diagnostics 

Listed  below  are  possible  error  messages  if  failures  are  detected: 

DIAG-BADINT 

DIAG-CMICKSUM 

DIAG-CMIDATA 

DIAG-CMIINVCAP 

DIAG-CMINOCAP 

DIAG-CMISAl 

DIAG-INTNIL 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

camTest 

centralMemoryTest 
cmemRetentionTest 
crossPortTest 
itemList 

portLoopbackTest 
spinSilk 

sramRetentionTest 
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config  Default 


Resets  a  subset  of  configuration  settings  to  their  defaults. 


Synopsis 


conf igdef ault 


Availability 


admin 


Description 


Use  this  command  to  reset  a  subset  of  configuration  settings  to  the  default  values. 
All  configuration  parameters,  with  the  following  exceptions,  are  reset: 


Ethernet  MAC  address,  IP  address,  and  subnetmask 


IP  gateway  address 
License  keys 


•  OEM  customization 

•  Product  ID  and  vendor  ID 

•  SNMP  configuration 

•  System  name 

•  World  Wide  Name 

•  HP  Advanced  Zoning  configuration 

•  Security  parameters  and  policies 

•  Switch  PID  format 

•  Ethernet  link  mode 

Some  configuration  parameters  are  cached  by  the  system.  To  avoid  unexpected  switch  behavior,  reboot 
the  system  after  executing  this  command. 

NOTE:    Refer  to  the  configure  command  for  more  information  on  default  values  for  configuration 


This  command  cannot  be  executed  on  an  enabled  switch.  You  must  first  disable  the  switch  using  the 

switchDisable  command. 


parameters. 


Some  configuration  parameters  are  cached  by  the  system.  To  avoid  unexpected  system  behavior,  reboot 
the  system  after  exciting  this  command. 


Operands 


none 
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Examples 

To  restore  the  system  configuration  to  default  values: 


switch : admin>  conf igdef ault 
Committing  Configuration  ...done. 


See  also 

agtCfgDefault 
configure 
switchDi sable 
switchEnable 
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config  Down  load 

Downloads  a  switch  configuration  file  from  a  host  file. 

Synopsis 

conf  igdownload   [ -p  ftp]   "  host" ,"  user"  ,"  file  ,"  passwd" 
conf  igdownload  -p  scp  "  host" ,"  user"  ,"  file" 
conf igdownload 

Availability 

admin 

Description 

Use  this  command  to  download  a  switch  configuration  file  from  a  host  file.  The  configuration  file  is  ASCII 
text  and  might  have  been  generated  using  conf  igUpload,  or  it  might  have  been  created  by  a  user  to 
download  specific  configuration  changes.  Refer  to  conf  igUpload  for  a  configuration  file  format 
description. 

To  restore  the  configuration  file  from  a  Microsoft®  Windows  NT®  system  using  file  transfer  protocol  (FTP), 
the  FTP  server  might  have  to  be  installed  from  the  distribution  media  and  enabled.  The  FTP  service  is 
widely  available  on  UNIX®  hosts  but  less  so  on  Windows®  hosts.  The  FTP  server  must  be  running  before  a 
download  can  occur. 

Use  -p  scp  to  securely  download  the  file  through  an  SSH  connection.  Instead  of  entering  a  password  on 
the  command  line,  SCP  prompts  you  for  the  password,  if  necessary.  The  SSH  service  is  available  on  both 
UNIX  and  Windows  hosts. 

This  command  can  be  invoked  without  any  operands,  creating  an  interactive  session. 
The  download  might  fail  for  the  following  reasons: 

•  The  switch  has  not  been  disabled. 

•  The  host  name  is  not  known  to  the  switch. 

•  The  host  IP  address  cannot  be  contacted. 

•  The  user  does  not  have  permission  on  the  host. 

•  The  user  runs  a  script  that  prints  something  at  login. 

•  The  file  does  not  exist  on  the  host. 

•  The  file  is  not  a  switch  configuration  file. 

•  The  FTP  server  is  not  running  on  the  host. 

•  The  configuration  data  contains  errors. 

When  the  switch  is  in  secure  mode,  the  following  rules  and  restrictions  apply: 

•  Both  defined  security  policies  and  active  security  policies  sections  must  exist  and  contain  the 
FCS_POLICY. 

•  In  the  defined  security  policies  section,  at  least  one  member  of  the  FCS_POLICY  must  be  the  same  as  a 
member  in  the  previous  FCS_POLICY. 

•  In  the  active  security  policy  section,  the  FCS_POLICY  must  be  exactly  the  same  as  the  previous 
FCS_POLICY.  Order  of  members  must  be  maintained. 

Fabric  OS  5.0.0  command  reference  guide   1 1 1 


•  If  either  security  policies  section  has  a  RSNMP  POLICY,  then  that  section  must  have  a 
WSNMP_POLICY. 

•  After  the  switch  is  enabled,  if  the  switch  is  the  primary  PCS,  then  its  security  and  zoning  information 
will  be  propagated  to  all  other  switches  in  the  fabric. 

•  After  the  switch  is  enabled,  if  the  switch  is  a  non-FCS  or  a  backup  PCS,  then  its  security  and  zoning 
information  will  be  overwritten  by  the  primary  PCS. 


NOTE:    A  license  key  is  only  accepted  if  the  boot.mac  line  matches  the  World  Wide  Name  of  the  switch 


performing  the  download;  otherwise,  it  is  ignored. 

Security  parameters  and  the  switch's  identity  cannot  be  changed  by  conf  igDownload.  Parameters  such 
as  the  switch  name  and  IP  address  are  ignored;  they  are  lines  in  the  configuration  file  that  begin  with 
"boot".  Security  parameters  such  as  secure  mode  setting  and  version  stamp  are  ignored;  they  are  the  lines 
in  the  configuration  file  that  begin  with  "sec". 

conf  igDownload  does  not  enable  security  mode,  even  if  the  configuration  file  is  saved  in  security  mode. 

After  conf  igDownload,  the  policy  might  require  up  to  8  minutes  to  download. 

The  download  process  is  additive;  that  is,  the  lines  read  from  the  file  are  added  to  the  current  switch 
configuration.  This  enables  you  to  change  a  single  configuration  variable  by  downloading  a  file  with  a 
single  line.  All  other  variables  remain  unchanged. 


The  R_A_TOV,  E_D_TOV,  WAN_TOV,  and  MAX_HOPS  configuration  parameters  are  interrelated. 
Assigning  a  specific  value  to  one  or  more  of  these  parameters  might  change  the  range  of  allowed  values 
that  can  be  assigned  to  the  other  parameters.  As  a  result,  the  user  might  not  be  able  to  set  all  the  values 
within  the  range  displayed  against  each  parameter.  This  utility  validates  the  modified  values  of  these  four 
parameters  and  terminates  the  download  operation,  if  the  validation  check  fails. 

This  is  particularly  important  when  downloading  a  zoning  configuration.  Since  the  new  zoning 
information  is  added  to  the  current  configuration,  there  might  not  be  any  conflicts.  If  the  current  zoning 
configuration  is  to  be  replaced,  the  keyword  "clear:"  might  be  inserted  into  the  configuration  file 
immediately  before  the  zoning  lines  (starting  from  the  line  "[Zoning]"). 

If  the  configuration  file  contains  the  keyword  "enable:  <zone_configuration>",  then  that  zoning 
configuration  enables  in  the  fabric.  If  there  is  no  "enable:"  keyword  in  the  configuration  file  or  no  zoning 
configuration  by  that  name  exists,  or  if  enable  fails  for  any  reason  (such  as  dangling  aliases),  then: 

•  The  effective  configuration  remains  as  it  was  prior  to  conf  igDownload;  that  is,  all  the  "enable:" 
information  is  discarded. 

•  The  defined  configuration  changes  to  reflect  new  zoning  configuration. 


Operands 


This  command  has  the  following  optional  operands: 


host 


user 


-P 


Specifies  the  use  of  the  FTP  or  SCP  protocol.  If  a  protocol  is  not  specified, 
FTP  is  the  default. 

Specifies  a  host  name  or  IP  address  in  quotation  marks:  for  example, 
"citadel"  or  "1 92. 1 68.1 .48".  The  configuration  file  is  downloaded  from 
this  host. 

Specifies  the  user  name,  in  quotation  marks:  for  example,  "jdoe".  This  user 
name  is  used  to  gain  access  to  the  host  system. 
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file  Specifies  the  file  name,  in  quotation  marks:  for  example,  "conf  ig.  txt". 

Absolute  path  names  might  be  specified  using  a  forward  slash  (/).  Relative 
path  names  search  for  the  file  in  the  user's  home  directory  on  UNIX  hosts 
and  in  the  directory  on  which  the  FTP  server  is  running  on  Windows  hosts. 

passwd  Specifies  the  password  for  the  FTP  login. 

Examples 

To  download  a  configuration  file  using  FTP  from  host  "citadel",  using  account  "jdoe",  and  file 
conf ig . txt  : 

switch :  ac3inin>  conf igdownload  -p  ftp 
"citadel " , "jdoe" , " conf ig . txt " , "passwd" 

Committing  conf iguration ...  done . 

download  complete 


To  download  the  same  configuration  file  using  SCP: 


switch : admin>  conf igDownload  -p  scp  "citadel", 

, "jdoe" , 

" conf ig . txt " 

jdoeScitadel ' s  password:  ******** 

Committing  conf iguration ...  done . 

download  complete 

See  also 

conf igDef ault 
conf igShow 
conf igUpload 
configure 
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configShow 

Displays  system  configuration  settings. 

Synopsis 

configshow  ["filter"] 

Availability 

all  users 

Description 

Use  this  command  to  view  the  system  configuration  settings  set  by  the  configure  command. 

Operands 

This  command  has  the  following  optional  operand: 

filter  Specify  a  text  string,  in  quotation  marks,  that  limits  the  output  of 

the  command  to  only  those  entries  that  contain  the  text  string. 

Examples 

To  display  system  configuration  settings: 


NOTE:    Not  all  values  displayed  are  applicable  to  all  system  models  and  configurations. 


switch : admin>  configshow 
diag.postDisable:  0 


fabric 

domain:  1 

fabric 

ops 

BBCredit:  16 

fabric 

ops 

E_D_TOV :            2  00  0 

fabric 

ops 

R_A_TOV:  10000 

fabric 

ops 

dataFieldSize : 

2112 

fabric 

ops 

max_hops :  7 

fabric 

ops 

mode . f cpProbeDisable 

fabric 

ops 

mode . isolate : 

0 

fabric 

ops 

mode . pidFormat : 1 

fabric 

ops 

mode . tachyonCompat : 

0 

fabric 

ops 

mode . unicas  tOnly : 

0 

fabric 

ops 

mode . useCsCtl : 

0 

fabric 

ops 

mode . vcEncode : 

0 

fabric 

ops 

vc . class . 2 :  2 

fabric 

ops 

vc . class . 3 :  3 

fabric 

ops 

vc.config:  OxcO 

(continued  on  next  page) 
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switch : adinin>  configshow 

diag.postDisable : 

0 

fabric . domain :  1 

fabric . ops . vc . linkCtrl : 

0 

fabric . ops . vc .multicast : 

7 

fabric  .  ops  .  wan_tov : 

0 

f  c4  .  f  dp .  address  : 

192 . 168 . 65 . 62 

f  c4  .  f  dp  .mask :  255.255. 

255  .  0 

f cAL . f anFrameDisable : 

0 

f cAL . useAltBBCredit : 

0 

IcdContrast:         12  8 

licenseKey:  none 

rpc.rstatd:  1 

rpc.rusersd:  1 

See  also 

agtCf gShow 

configure 

diagDisablePost 

diagEnablePost 

ipAddrShow 

licenseShow 

syslogdlpShow 
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config  Upload 


Uploads  the  switch  configuration  file  to  a  host  file. 


Synopsis 


conf igupload   [ -p  ftp   I    scp] [host , user , file[ , passwd] ] 


Availability 

admin 

Description 

Use  this  command  to  upload  the  switch  configuration  to  a  host  file. 

To  upload  the  configuration  file  from  a  Microsoft  Windows  NT  system  using  file  transfer  protocol  (FTP),  the 
FTP  server  might  have  to  be  installed  from  the  distribution  media  and  enabled.  The  FTP  service  is  widely 
available  on  UNIX  hosts  but  less  so  on  Windows  hosts.  The  FTP  server  must  be  running  before  a  download 
can  occur. 

Use  -p  scp  to  securely  upload  the  file  through  an  SSH  connection.  Instead  of  entering  a  password  on  the 
command  line,  SCP  prompts  you  for  the  password,  if  necessary.  The  SSH  service  is  available  on  both 
UNIX  and  Windows  hosts. 

If  the  command  is  entered  without  operands,  it  becomes  interactive  and  prompts  the  user  for  input. 
The  upload  might  fail  for  the  following  reasons: 
The  host  name  is  not  known  to  the  switch. 
The  host  IP  address  cannot  be  contacted. 
The  user  does  not  have  permission  on  the  host. 
The  user  runs  a  script  that  prints  something  at  login. 
The  FTP  server  is  not  running  on  the  host. 
There  are  three  types  of  lines  in  the  configuration  file: 

License  keys  are  encrypted  ASCii  strings  and  are  listed  one  key  per  line. 

Comments  have  a  bracket  (  [  )  as  the  first  character  of  the  line.  (When  read  by  conf  igDownload,  a 
line  beginning  with  any  punctuation  is  treated  as  a  comment.) 

Name:value  pairs  have  the  following  syntax: 


line 

name 

space 

component 

value 


name   :  value 
component  {"."  component} 
{"  "  I  t"} 

II   n   I   II  kii     ii-in   I   II  r\ii     iiC\ii   \    "    "   \   >'  " 


{<any  character  not  including  n">} 


■"} 


NOTE:  Elements  enclosed  in  curly  braces  (  {...}  )  indicate  zero  or  more  occurrences  of  the  enclosed 
elements. 
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The  configuration  file  is  written  as  three  sections.  The  first  section  contains  the  switch  boot  parameters.  It 
has  variables  such  as  the  switch's  name  and  IP  address.  This  section  corresponds  to  the  first  few  lines  of 
output  of  the  conf  igShow  command. 

The  second  section  contains  general  switch  configuration  variables,  such  as  diagnostic  settings,  fabric 
configuration  settings,  and  SNMP  settings.  This  section  corresponds  to  the  output  of  the  conf  igShow 
command  (after  the  first  few  lines),  although  there  are  more  lines  uploaded  than  shown  by  the  command. 

The  third  sections  contains  zoning  configuration  parameters. 


r^^f  NOTE:  In  Fabric  OS  v4.x,  no  spaces  are  allowed  between  operands.  None  of  the  operands  use 
li— I    quotation  marks. 


Operands 

This  command  has  the  following  optional  operands: 

host  Specify  a  host  name  or  IP  address,  in  quotation  marks:  for  example,  "citadel"  or 

"192  .168.1.48".  The  configuration  file  is  downloaded  from  this  host  system. 

user  Specify  a  user  name  in  quotation  marks:  for  example,  "jdoe".  This  user  name  is 

used  to  gain  access  to  the  host. 

file  Specify  a  file  name  in  quotation  marks;  for  example:  "conf  ig.  txt".  Absolute 

path  names  might  be  specified  using  forward  slash  (/).  Relative  path  names  create 
the  file  in  the  user's  home  directory  on  UNIX  hosts  and  in  the  directory  where  the 
FTP  server  is  running  on  Windows  hosts. 

passwd  Specify  a  password,  in  quotation  marks. 

Examples 

To  upload  a  configuration  file  using  FTP  to  host  "citadel",  using  account  "jdoe",  and  file 
conf ig . txt  : 


switch; 

:admin>  configupload  "citadel", 

, "jdoe" , 

" conf ig . txt " , 

, "passwd" 

upload 

complete 

To  upload  the  same  configuration  file  using  SCP: 


switch :adinin>  configupload  -p  scp  " citadel "," j doe "," conf ig . txt ' 
jdoe@citadel ' s  password:  ******** 


upload  complete 

To  upload  the  configuration  file  interactively: 

sw5 : admin>  configupload 

Protocol    (scp  or  ftp)    [ftp]:  ftp 

Server  Name  or  IP  Address   [host] :  123. 

.  123 . 123 . 123 

User  Name   [None] :  user21 

File  Name   [config.txt] :   conf ig-switch . 

,  txt 

Password:  xxxxxxxx 

upload  complete 
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See  also 

configDe fault 
conf igDownload 
conf igShow 
configure 
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configure 


Modifies  system  configuration  parameters. 


Synopsis 


configure 


Availability 

admin 


Description 

Use  this  command  to  change  the  following  system  configuration  parameters: 
Switch  fabric  settings 
Virtual  channel  settings 
Zoning  operation  parameters 
RSCN  transmission  mode 
Arbitrated  loop  parameters 
System  services 
Portlog  events  settings 
Application  attributes 


[—}f  NOTE:    If  executed  on  an  enabled  switch,  only  the  application  attribute  can  be  configured.  To  access  all 
parameters  controlled  by  this  command,  you  must  disable  the  switch  using  the  switchDisable 
command. 


The  configure  command  is  navigated  using  a  series  of  menus.  Top-level  and  associated  submenus 
consist  of  a  text  prompt,  a  list  of  acceptable  values,  and  a  default  value  (in  brackets). 


Use  the  following  options  to  control  input: 


Return 

Interrupt 
(Ctrl-C) 

End-of-f ile 
(Ctrl-D) 


When  entered  at  a  prompt  with  no  preceding  input,  accepts  the 
default  value  (if  applicable)  and  moves  to  the  next  prompt. 

Aborts  the  command  immediately  and  ignores  all  changes 
made.  This  keystroke  is  common  on  many  computers  but  can  be 
different  on  your  system. 

When  entered  at  a  prompt  with  no  preceding  input,  terminates 
the  command  and  saves  changes  made.  This  keystroke  is 
common  on  many  computers  but  might  be  different  on  your 
system. 


Switch  fabric  settings 

There  are  several  settings  that  control  the  overall  behavior  and  operation  of  the  fabric.  Some  of  these,  such 
as  the  domain,  are  assigned  automatically  by  the  fabric  and  might  differ  from  one  switch  to  another  in  the 
fabric.  Other  parameters,  such  as  the  BB  credit,  can  be  changed  for  specific  applications  or  operating 
environments  but  must  be  in  agreement  among  all  switches  to  allow  formation  of  the  fabric. 
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Table  6  lists  the  Fabric  Parameters  fields  and  their  settings. 
Table  6    Configure  command  Fabric  Parameters  fields 


Field 

Type 

Default 

Range 

Domain 

number 

1 

varies 

R_A_TOV 

number 

10000 

E_D_TOV  *  2  to  1 20000 

E_D_TOV 

number 

2000 

1 000  to  R_A_TOV  /  2 

WAN_TOV 

number 

0 

0  to  R_A_TOV  /  4 

MAX_HOPS 

number 

7 

7  to  19 

Data  Field  Size 

number 

21 12 

256  to  21 12 

Sequence  Level  Switching 

boolean 

0 

Oor  1 

Disable  Device  Probing 

boolean 

0 

Oor  1 

Suppress  Class  F  Traffic 

boolean 

0 

Oor  1 

Switch  FID  Format 

number 

1 

1  to  2 

Per-frame  Route  Priority 

boolean 

0 

Oor  1 

Long  Distance  Fabric 

boolean 

0 

Oor  1 

BB  Credit 

number 

16 

1  to  27 

Insistent  Domain  ID  Mode 

boolean 

0 

Oor  1 

Descriptions  of  the  switch  fabric  setting  fields  are  as  follows 
Domain 


R  A  TOV 


E  D  TOV 


WAN  TOV 


The  domain  number  uniquely  identifies  the  switch  in  a  fabric. 
This  value  is  automatically  assigned  by  the  fabric.  The  range  of 
valid  values  varies  depending  on  the  switch  model  and  other 
system  parameter  settings. 

The  resource  allocation  time  out  value  (R_A_TOV)  is  displayed  in 
milliseconds.  This  variable  works  with  the  variable  E_D_TOV  to 
determine  switch  actions  when  presented  with  an  error 
condition. 

Allocated  circuit  resources  with  detected  errors  are  not  released 
until  the  time  value  has  expired.  If  the  condition  is  resolved  prior 
to  the  time  out,  the  internal  time-out  clock  resets  and  waits  for  the 
next  error  condition. 

Error  detect  time  out  value  (E  D  TOV)  is  displayed  in 
milliseconds.  This  timer  is  used  to  flag  a  potential  error  condition 
when  an  expected  response  is  not  received  (an  acknowledgment 
or  reply  in  response  to  packet  receipt,  for  example)  within  the  set 
time  limit.  If  the  time  for  an  expected  response  exceeds  the  set 
value,  then  an  error  condition  occurs. 

Wide  area  network  time  out  value  (WAN_TOV)  displays  in 
milliseconds.  This  timer  is  the  maximum  frame  time  out  value  for 
a  WAN,  if  any,  interconnecting  the  Fibre  Channel  islands. 
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MAX_HOPS  Maximum  hops  (MAX_HOPS)  is  an  integer  that  denotes  the 

upper  limit  on  the  number  of  hops  a  frame  might  have  to  traverse 
to  reach  any  destination  port  from  any  source  port  across  the 
fabric. 


NOTE:    The  R_A_TOV,  E_D_TOV,  WAN_TOV,  and  MAX_HOPS  configuration  parameters  are 
inter-related.  Assigning  a  specific  value  to  one  or  more  of  these  parameters  can  change  the  range  of 
allowed  values  that  can  be  assigned  to  the  other  parameters.  As  a  result,  the  user  might  not  be  able  to  set 
all  the  values  within  the  range  displayed  against  each  parameter.  To  reduce  problems,  the  configuration 
utility  validates  the  modified  parameter  values  and  prompts  the  user  to  re-enter  some  values,  if  the 
validation  check  fails. 


Data  Field  Size 


Sequence-Level  Switching 


Disable  Device  Probing 


Suppress  Class  F  Traffic 


Switch  PID  Format 


Per-frame  Route  Priority 


Long  Distance  Fabric 


The  data  field  size  specifies  the  largest  possible  value,  in  bytes,  and 
advertises  this  value  to  other  switches  in  the  fabric  during  construction 
of  the  fabric  as  well  as  to  other  devices  when  they  connect  to  the 
fabric.  Setting  this  to  a  value  smaller  than  2112  might  result  in 
decreased  performance. 

When  sequence-level  switching  is  set  to  1,  frames  of  the  same 
sequence  from  a  particular  source  are  transmitted  as  a  group.  When 
this  feature  is  set  to  0,  frames  are  transmitted  interleaved  among 
multiple  sequences. 

Under  normal  conditions,  sequence-level  switching  should  be  disabled 
for  better  performance.  However,  some  host  adapters  have 
performance  issues  when  receiving  interleaved  frames  from  multiple 
sequences.  When  there  are  such  devices  attached  to  the  fabric, 
sequence-level  switching  should  be  enabled. 

When  disable  device  probing  is  set  to  1 ,  devices  that  do  not  register 
with  the  name  server  are  not  present  in  the  name  server  data  base.  Set 
this  mode  only  if  the  switch  N  Port  discovery  process  (PLOGI,  PRLI, 
INQUIRY)  causes  an  attached  device  to  fail. 

When  this  mode  is  set  to  1,  all  Class  F  interswitch  frames  are 
transmitted  as  Class  2  frames.  This  is  to  support  remote  fabrics  that 
involve  ATM  gateways,  which  don't  support  class  F  traffic. 

The  formats  are  as  follows: 

0  Native  PID  format  (16  based,  1 6  port  format),  for  fabrics 
with  legacy  low-count-port  switches. 

1  Core  PID  format  (0  based,  256  port  format),  preferred 
mode  for  mixed  fabrics  with  legacy  and  new  switches. 

2  Extended  edge  PID  format  (16  based,  256  port  format), 
used  in  mixed  fabrics  with  legacy  and  new  switches  to 
avoid  need  to  reboot  host  systems  when  static  PID  binded  is 
used. 

In  addition  to  the  eight  virtual  channels  used  in  frame  routing  priority, 
support  is  also  available  for  per-frame-based  prioritization  when  this 
value  is  set.  When  Per-frame  Route  Priority  is  set  to  1 ,  the  virtual 
channel  ID  is  used  in  conjunction  with  a  frame  header  to  form  the  final 
virtual  channel  ID. 

When  this  mode  is  set  to  1 ,  ISLs  in  a  fabric  can  be  up  to  1 00  km  long. 
The  exact  distance  level  is  determined  by  the  per-port  configuration  on 
the  E  Ports  of  each  ISL.  Both  E_Ports  in  an  ISL  must  be  configured  to  run 
the  same  long-distance  level;  otherwise,  the  fabric  will  be  segmented. 
The  Extended  Fabric  License  is  required  to  set  this  mode. 
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NOTE:    An  HP  Extended  Fabrics  license  is  required  to  set  this  mode. 


BB  Credit  The  buffer-to-buffer  (BB)  credit  represents  the  number  of  buffers 

available  to  attached  devices  for  frame  receipt.  The  range  of  allov/ed 
values  varies  depending  on  other  system  settings. 

Insistent  Domain  ID  mode        This  mode  enables  a  flag  for  the  domain  ID,  so  that  the  current  domain 

setting  for  the  switch  is  insistent:  that  is,  remains  the  same  over  switch 
reboots,  power  cycles,  CP  failovers,  firmware  downloads,  and  fabric 
reconfigurations.  If  a  switch  does  not  get  the  selected  insistent  domain 
ID  during  a  fabric  reconfiguration,  it  segments  itself  out  of  the  fabric 

Virtual  channel  settings 

The  switch  enables  fine-tuning  for  a  specific  application  by  configuring  the  parameters  for  eight  virtual 
channels.  The  first  two  virtual  channels  are  reserved  for  switch  internal  functions  and  are  not  available  for 
modification. 

The  default  virtual  channel  settings  have  already  been  optimized  for  switch  performance.  Changing  the 
default  values  can  improve  switch  performance  but  can  also  degrade  performance.  Do  not  change  these 
settings  without  fully  understanding  the  effects  of  the  changes. 

Table  7  lists  the  Virtual  Channel  fields  and  their  settings. 


Table  7    Configure  command  Virtual  Channel  fields 


Field 

Default 

Range 

VC  Priority  2 

2 

2  to  3 

VC  Priority  3 

2 

2  to  3 

VC  Priority  4 

2 

2  to  3 

VC  Priority  5 

2 

2  to  3 

VC  Priority  6 

3 

2  to  3 

VC  Priority  7 

3 

2  to  3 

VC  Priority  specifies  the  class  of  frame  traffic  given  priority  for  a  virtual  channel. 

Zoning  operation  parameters 

The  Zoning  Operation  Parameter  field  is  as  follows: 

Disable  NodeName  Specify  1  to  disable  using  node  WWN  when  specifying  nodes 
Zone  Checking  in  the  zone  database,  or  specify  0  to  enable  using  node  WWN 

when  specifying  nodes  in  the  zone  data.  The  default  value  is  0. 

This  value  must  be  set  to  1  for  interoperability. 
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RSCN  Transmission  mode 

Table  8  lists  the  RSCN  Transmission  Mode  fields  and  their  settings. 
Table  8    RSCN  Transmission  Modes  fields 


Field 

Type 

Default 

Range 

End-device  RSCN  Transmission  Mode 

number 

1 

0to2 

Domain  RSCN  to  End-device  for  sv/itch  IP  address  or  name  change 

number 

0 

Oto  1 

Descriptions  of  the  RSCN  Transmission  Mode  field  values  are  as  follows 
End-device  RSCN  Transmission  Mode 


Domain  RSCN  to  End-device  for  switch 
IP  address  or  name  change 


Values  are  as  follows: 

0  RSCN  with  single  PID  (default) 

1  RSCN  with  multiple  PIDs 

2  Fabric  RSCN 

Values  are  as  follows: 
0 


1 


Disabled.  No  domain  RSCN  is  sent  to  the 
end-device  for  the  switch  IP  address  or  name 
change. 

Enabled.  Domain  RSCN  is  sent  to  the  end-device 
for  the  switch  IP  address  or  name  change. 


Arbitrated  Loop  parameters 

Table  9  lists  the  Arbitrated  Loop  Parameter  fields. 

Table  9   Configure  command  Arbitrated  Loop  Parameter  fields 


Field 

Default 

Range 

Alternate  BB  Credit? 

0 

0  or  1 

Send  FAN  frames? 

1 

0  or  1 

Enable  CLOSE  on  OPEN  received? 

4 

Oto  4 

Alv\/ays  send  RSCN? 

0 

0  or  1 

Do  Not  Allov/  AL_PA  0x00? 

0 

0  or  1 

Descriptions  of  the  Arbitrated  Loop  Parameter  fields  are  as  follows: 

Sets  or  resets  the  alternate  BB  credit  feature. 

Specifies  that  fabric  address  notification  (FAN)  frames  be  sent  to 
public  loop  devices  to  notify  them  of  their  node  ID  and  address. 
When  set  to  1 ,  frames  are  sent;  when  set  to  0,  frames  are  not 
sent. 


Alternate  BB  Credit? 
Send  FAN  frames? 


Enable  CLOSE  on  OPEN 
received? 


If  this  is  set,  a  CLS  is  returned  immediately  to  an  OPN  if  no 
buffers  are  available.  This  is  required  for  TachLite. 
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Always  send  RSCN?  Following  the  completion  of  loop  initialization,  a  remote  state 

change  notification  (RSCN)  is  issued  when  FL  Ports  detect  the 
presence  of  new  devices  or  the  absence  of  preexisting  devices. 
When  set,  a  RSCN  is  issued  upon  completion  of  loop 
initialization,  regardless  of  the  presence  or  absence  of  new  or 
pre-existing  devices. 

Do  Not  Allow  AL_PA  0x00?     This  option  disables  AL_PA  values  from  0x00. 


System  Services 

Table  1  0  lists  the  System  Services  fields  and  their  settings. 
Table  10   Configure  command  System  Services  fields 


Field 

Default 

Range 

rstatd 

Off 

On/Off 

rusersd 

Off 

On/Off 

telnetd 

On 

On/Off 

thad 

On 

On/Off 

Disable  RLS  probing 

On 

On/Off 

Descriptions  of  the  system  service  (setting)  fields  are  as  follows: 


rstatd 


rusersd 


telnetd 


thad 

Disable  RLS  probing 


Dynamically  enables  or  disables  a  server  that  returns  system 
operation  information  through  remote  procedure  calls  (RFC).  The 
protocol  provides  for  a  wide  range  of  system  statistics. 

The  retrieval  of  this  information  is  supported  by  a  number  of 
operating  systems  that  support  RFC.  Most  UNIX-based  systems 
(HF-UX,  Irix,  Linux,  Solaris,  and  so  on.)  use  the  RUF  and 
RSYSINFO  commands  to  retrieve  the  information.  Refer  to  your 
local  system  documentation  for  the  appropriate  usage  of  the 
these  or  equivalent  commands. 

Dynamically  enables  or  disables  a  server  that  returns  information 
about  the  user  logged  into  the  system  through  remote  procedure 
calls  (RFC).  The  information  returned  includes  user  login  name, 
system  name,  login  protocol  or  type,  login  time,  idle  time,  and 
remote  login  location  (if  applicable). 

The  retrieval  of  this  information  is  supported  by  a  number  of 
operating  systems  that  support  RFC.  On  most  UNIX-based 
systems  (HF-UX,  Irix,  Linux,  Solaris,  and  so  on.)  the  command  to 
retrieve  the  information  is  rusers.  Refer  to  your  local  system 
documentation  for  the  appropriate  usage  of  this  or  an  equivalent 
command. 

Used  to  enable  or  disable  the  telnet  interface  to  a  switch, 
including  sectelnet.  If  you  are  using  SSH  to  manage  a  switch, 
you  can  disable  the  telnet  interface  for  greater  security.  The 
default  value  is  on  (telnet  enabled). 

Dynamically  enables  or  disables  the  HF  Fabric  Watch  services. 

Enables  or  disables  FCF  read  link  status  (RLS)  information 
probing  for  F/FL_Fort.  It  is  disabled  by  default. 
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Portlog  Events  Enable 

Specifies  which  events  create  an  entry  in  the  port  log. 
Application  Attributes 

Application  attributes  HTTP,  SNMP,  and  RPCd  are  configurable;  by  default,  all  three  attributes  are 
enabled.  See  Table  1  1  for  the  application  attributes  that  can  be  changed. 

Table  1 1    Configurable  application  attributes 


Application 

File 

Type 

Default 

Range 

SSL 

Certificate  File 

string 

not  set 

varies 

CA  Certificate  File 

string 

not  set 

varies 

Length  of  crypto  key 

number 

128 

40,  56,  1  28 

HTTP 

HTTP  Enable 

boolean 

on 

on/ off 

Secure  HTTP  Enabled 

boolean 

off 

on/ off 

AccessLog  Enabled 

boolean 

off 

on/ off 

ErrorLog  Enabled 

boolean 

off 

on/ off 

SNMP 

SNMP  Security  Level 

number 

0 

0,  1,  2 

RPCd 

RPCd  Enabled 

boolean 

on 

on/  off 

Secure  RPCd  Enabled 

boolean 

off 

on/ off 

Secure  RPCd  Callback 

boolean 

off 

on/ off 

Secure  RPCd  Secret 

boolean 

secret 

varies 

cfgload 

Secure  Config  Upload  and  Dov/nload 

boolean 

off 

on/ off 

NOTE:   The  secure  protocols  must  not  be  enabled  before  setting  SSL  attributes  correctly. 


Operands 

none 
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Examples 

To  set  the  configuration  parameters  for  a  switch: 

switch : admin>  configure 
Configure . . . 

Fabric  parameters (yes ,   y,   no,   n) :    [no]  yes 

Domain:  (1.  .239)  [1] 

R_A_TOV:    (4000.  .120000)  [10000] 

E_D_TOV:    (1000.. 5000)    [2000]  5000 

WAN_TOV:     (0.. 30000)     [0]  0 

MAX_HOPS:    (7. .19)  [7] 

Data  field  size:    (256.. 2112)  [2112] 

Sequence  Level  Switcliing:    (0..1)    [0]  1 

Disable  Device  Probing:    (0..1)  [0] 

Switcli  FID  Format:    (1..2)  [1] 

Per-frame  Route  Priority:    (0..1)  [0] 

BB  credit:    (1.  .16)  [16] 

Insistent  Domain  ID  Mode   (yes,   y,   no,   n) :  [no] 
Virtual  Channel  parameters (yes ,  y,   no,   n) :    [no]  yes 


vc 

Priority 

2  : 

(2  . 

.3) 

[2] 

vc 

Priority 

3  : 

(2  . 

.3) 

[2] 

vc 

Priority 

4  : 

(2  . 

.3) 

[2] 

vc 

Priority 

5  : 

(2  . 

.3) 

[2] 

vc 

Priority 

6  : 

(2  . 

.3) 

[3] 

vc 

Priority 

7  : 

(2. 

.3) 

[3] 

Switch  Operating  Mode   (yes,  y,   no,   n) :    [no]  yes 
Interoperability  Mode:    (0..1)  [0] 

Zoning  Operation  parameters   (yes,  y,   no,   n) :    [no]  yes 
Disable  NodeName  Zone  Checking:    (0..1)  [0] 
RSCN  Transmission  Mode   (yes,   y,   no,   n) :    [no]  yes 
End-device  RSCN  Transmission  Mode 

(0  =  RSCN  with  single  PID,  1  =  RSCN  with  multiple  PIDs,  2  =  Fabric 
RSCN):    (0..2)  [0] 

(continued  on  next  page) 
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Arbitrated  Loop  parameters (yes ,   y,   no,   n) :    [no]  yes 

Alternate  BB  credit:    (0..1)  [0] 

Send  FAN  frames?:    (0..1)  [1] 

Enable  CLOSE  on  OPEN  received?:    {0..1)  [0] 

Always  send  RSCN? :    (0..1)  [0] 

Do  Not  Allow  AL_PA   0x00?:     (O.-l)  [0] 

System  services (yes ,   y,   no,   n) :    [no]  yes 

rstatd(on,   off) :  [off] 
rusersd(on,   off):  [off] 
telnetd  (on,   off) :  [on] 

Portlog  events  enable     (yes,  y,  no,  n) :    [no]  yes 
start(a  switch  start  or  re-start  event)    (on,   off):  [on] 
disable(a  port  is  disabled"   )  (on,   off):  [on] 

enable(a  port  is  enabled)  (on,   off):  [on] 

ioctl(a  port  I/O  control  is  executed)         )  (on,   off):  [on] 

(output  truncated) 

Committing  configuration ...  done . 

See  also 

agtCfgDe fault 
agtCfgSet 
agtCf  gSliow 
configDe fault 
conf  igSliow 
ipAddrSet 

portCfgLongDi stance 
switcliDi  sable 
switcliEnable 
upTime 
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crossPortTest 


Tests  functional  operation  of  port  external  transmit  and  receive  path. 

Synopsis 

crossporttest   [-nframes  count] [-lb_mode  mode]  [-spd_mode  mode]  [-norestore 
mode]  [-ports  itemlist] 

Availability 

admin 

Description 

This  command  verifies  the  intended  functional  operation  of  the  switch  by  sending  frames  from  port  M's 
transmitter  and  looping  them  back  through  an  external  fiber  cable  into  port  N's  receiver,  thus  exercising 
all  the  sv/itch  components,  from  the  main  board,  to  the  media,  to  the  fiber  cable,  to  the  media,  and  back 
to  the  main  board.  With  -lb_mode  set  to  1 ,  it  is  also  possible  to  test  ports  with  loopback  plugs  that 
connect  each  port  back  to  itself. 

The  cables  can  be  connected  to  any  port  combination  with  the  one  condition;  the  cables  and  media 
connected  must  be  of  the  same  technology.  This  means  a  short  wave-length  media  port  must  be  connected 
to  another  short  wave-length  media  port,  using  a  short  wave-length  cable,  a  long  wave-length  port  must 
be  connected  to  a  long  wave-length  port,  and  a  copper  port  must  be  connected  to  a  copper  port. 

For  best  coverage,  connected  ports  should  be  from  different  ASICs.  For  example.  Ports  0  through  3  belong 
to  ASIC  0,  ports  4  through  7  belong  to  ASIC  1,  and  so  forth.  A  connection  from  port  0  to  port  15 
exercises  the  transmit  path  between  ASICs.  A  connection  from  port  0  to  port  3  tests  only  the  internal 
transmit  path  in  ASIC  0. 

Only  one  frame  is  transmitted  and  received  at  any  one  time.  The  port  LEDs  flicker  green  while  the  test  is 
running. 

The  test  method  is  as  follows: 

1.  Determine  which  ports  are  connected  to  each  other. 

2.  Enable  ports  for  cabled  loopback  mode. 

3.  Create  a  Frame  F  of  maximum  data  size  (2112  bytes). 

4.  Transmit  Frame  F  through  Port  M. 

5.  Pick  up  the  frame  from  its  cross-connected  Port  N.  An  error  is  reported  if  any  port  other  than  N  actually 
received  the  frame. 

6.  Check  if  any  of  the  eight  statistic  error  counters  are  nonzero:  ENC_in,  CRC_err,  TruncFrm,  FrmTooLong, 
BadEOF,  Enc_out,  BadOrdSet,  or  DiscC3. 

7.  Check  if  the  transmit,  receive,  or  Class  3  receiver  counters  are  stuck  at  some  value. 

8.  Check  if  the  number  of  frames  transmitted  is  not  equal  to  the  number  of  frames  received. 

9.  Repeat  steps  3  through  8  for  all  ports  present  until  the  number  of  frames  requested  is  reached  or  all 
ports  are  marked  bad. 
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At  each  pass,  a  different  data  type  is  used  to  create  the  frame  from  a  palette  of  seven  types  meaning  that 
if  a  pass  of  seven  is  requested,  seven  different  frames  are  used  in  the  test.  If  eight  passes,  the  first  seven 
frames  are  unique,  and  the  eighth  is  the  same  as  the  first.  The  data  palette  of  seven  are: 


CSPAT: 

0x7  e, 

0x7e, 

0x7e, 

Ox7e, 

BYTE_LFSR: 

0x69, 

0x01, 

0x02  , 

0x05, 

CHALF_SQ : 

0x4a, 

Ox4a, 

Ox4a, 

Ox4a, 

QUAD_NOT  : 

0x00, 

Oxf  f , 

0x00, 

Oxff , 

CQTR_SQ : 

0x7  8, 

0x78, 

0x78, 

0x7  8, 

CRPAT : 

Oxbc, 

Oxbc, 

0x2  3, 

0x47  , 

RANDOM : 

0x2  5, 

0x7  f. 

0x6e, 

0x9a, 

The  crossPortTest  command  behaves  differently  depending  on  the  modes  activated: 


SwitchEnable  or  SwitchDisable  mode 

In  online  mode  (in  which  the  sv/itch  is  enabled  prior  to  executing  the  crossPortTest  command),  only 
ports  that  are  cable  loopbacked  to  ports  in  the  same  switch  are  tested.  Ports  connected  outside  of  the 
switch  are  ignored. 

To  run  the  crossPortTest  command  successfully  the  test  must  find  at  least  one  port  (lb_mode  =  1, 
this  is  the  default)  or  two  ports  (lb_mode  =  O)  cable  loopbacked  to  each  other.  If  this  criteria  is  not  met, 
one  of  the  following  message  is  displayed: 

Need  at  least  1  port(s)   connected  to  run  this  test. 

Need  at  least  2  port(s)   cross-connected  to  run  this  test. 

In  offline  mode  (when  the  switch  is  disabled  prior  to  executing  the  crossPortTest  command)  all  ports 
are  assumed  to  be  cable  loopbacked  to  different  ports  in  the  same  switch.  If  one  or  more  ports  are  not 
connected,  the  test  aborts. 

The  test  determines  which  port  is  connected  to  which  port  transmitting  frames.  If  any  ports  are  not  properly 
connected  (improperly  seated  SFPs  or  cables,  bad  SFPs  or  cables,  or  improper  connection  or  improper 
connection  of  SWL  to  LWL),  the  following  message  is  displayed: 

One  or  more  ports  is  not  active,   please  double  check 

fibre  channel  connections  on  all  ports. 

Since  this  test  includes  the  media  and  the  fiber  cable  in  its  test  path,  its  results  combined  with  the  results  of 
portLoopbackTest  and  spinSilk  can  be  used  to  determine  which  components  of  the  switch  are 
faulty.  It  is  also  possible  to  use  loopback  modes  3  and  5  to  further  isolate  failures;  refer  to  -lb_mode, 
below. 


Operands 

This  command  has  the  following  operands: 

-nf  rames  count    Specify  the  number  of  frames  to  send.  The  test  will  progress  until  the  specified 
number  of  frames  has  been  transmitted  on  each  port.  The  default  value  is  1 0. 

-lb_mode  mode      Specify  the  loopback  mode  for  the  test.  By  default,  crossPortTest  uses  mode 
1  port  loopback.  Valid  values  are: 


0  Cable  loopback 

1  Port  loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 

3  Silkscreen  loopback 

5  Internal  (parallel)  loopback 
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-spd_mode  mode    Specify  the  speed  mode  for  the  test.  This  parameter  is  used  only  for  Bloom  and 
Condor  ASIC-based  products,  for  which  it  controls  the  speed  at  which  each  port 
is  operated.  For  1  Gb/s-only  products  it  is  ignored.  The  exact  operation  of  each 
mode  5  through  8  depends  upon  the  loopback  mode  selected.  When  speed 
modes  5  through  8  are  used  with  cables,  they  must  be  connected  even  to  odd  or 
the  test  will  fail.  Valid  values  are: 

0  Run  test  at  both  1  Gb/s,  2  Gb/s,  and  4  Gb/s  (default) 

1  Set  all  port  speeds  to  1  Gb/s 

2  Set  all  port  speeds  to  2  Gb/s 
4  Set  all  port  speeds  to  4  Gb/s 

For  -lb_mode  set  to  0,1,  the  following  speed  modes  is  available  to  test  the 
speed  negotiation: 

3  Set  all  even  ports  speed  to  AN;  set  all  odd  ports  speed  to  1 
Gb/s. 

4  Set  all  even  ports  speed  to  AN;  set  all  odd  ports  speed  to  2 
Gb/s. 

5  Set  all  odd  ports  speed  to  AN;  set  all  even  ports  speed  to  1 
Gb/s. 

6  Set  all  odd  ports  speed  to  AN;  set  all  even  ports  speed  to  2 
Gb/s. 

For  -lb_mode  set  to  2,3,  the  following  speed  modes  are  available  to  test  FIFO 
underrun: 

3.5  Set  all  even  ports  speed  to  2  Gb/s;  set  all  odd  ports  speed  to 

1  Gb/s. 

4.6  Set  all  even  ports  speed  to  1  Gb/s;  set  all  odd  ports  speed  to 

2  Gb/s. 

-norestore     Specify  1  to  force  the  test  to  skip  part  of  the  POST  cleanup 
mode  normally  performed.  This  might  be  helpful  during  debug.  This 

parameter  should  normally  be  left  at  the  default  value  of  0. 

-ports  Specify  a  list  of  user  ports  to  test.  By  default,  all  the  user  ports 

itemlist         in  the  current  switch  will  be  used.  Refer  to  itemList  for  more 
information. 


Examples 


To  run  a  functional  test  of  all  the  ports  on  a  switch: 

switch: admin>  crossporttest  -ports  1/0-1/15 

Running  crossporttest   


Ports  Segmented  (0) 
Executing  test   . . . 

Test  Complete:    "crossporttest"  Pass  10  of  10 
Duration  0  hr,    0  min  &  8  sec  (0:0:8:725). 
passed. 
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Diagnostics 

Possible  error  messages  if  failures  are  detected: 

DATA 

EPI1_STATUS_ERR 


ERR_ 

_STAT 

ERR_ 

_STATS 

ERR_ 

_STATS_2  LONG 

ERR_ 

_STATS_BADEOF 

ERR_ 

_STATS_BADOS 

ERR__ 

_STATS_C3DISC 

ERR_ 

_STATS_CRC 

ERR_ 

_STATS_ENCIN 

ERR_ 

_STATS_ENCOUT 

ERR_ 

_STATS_TRUNC 

ERR_ 

_STAT_2L0NG 

ERR_ 

.STAT_BADEOF 

ERR_ 

.STAT_BADOS 

ERR_ 

.STAT_C3DISC 

ERR_ 

.STAT_CRC 

ERR_ 

_STAT_ENCIN 

ERR_ 

_STAT_ENCOUT 

ERR_ 

.STAT_TRUNC 

FDET_PERR 

FINISH_MSG_ERR 

FTPRT_STATUS_ERR 

INIT 

LESSN_STATUS_ERR 

MBUF_STATE_ERR 

MBUF_STATUS_ERR 

NO_SEGMENT 

PORT_ABSENT 

PORT_DIED 

PORT_ENABLE 

P0RT_M2M 

PORT_STOPPED 

PORT_WRONG 

RXQ_FRAME_ERR 

RXQ_RAM_PERR 

STATS 

STATS_C3FRX 

STATS_FRX 

STATS_FTX 

TIMEOUT 

XMIT 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 
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See  also 

camTest 

centralMemoryTest 
cmemRetentionTest 
cmiTest 
itemList 

portLoopbackTest 

portRegTest 

spinSilk 

sramRetentionTest 
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dataTypeShow 

Displays  sample  data  stream  types  used  in  some  diagnostic  commands. 

Synopsis 

datatypeshow   [-seed  value] 

Availability 

all  users 

Description 

Use  this  command  to  display  sample  data  stream  types  used  in  diagnostic  commands.  There  are  20 
different  sample  data  types.  The  command  displays  an  example  of  each  data  stream. 

Operands 

This  command  has  the  following  operand: 

-seed  value  Specify  the  data  pattern  seed  value.  If  no  seed  is  specified,  then 

a  seed  value  of  0  is  used. 

Examples 

To  display  sample  data  streams  you  can  use  with  diagnostics: 

switch :admin>  datatypeshow 

Pattern  type  example 


BYTE_FILL 

1 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00  00 

WORD_FILL 

2 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

QUAD_FILL 

3 

00000000 

00000000 

00000000 

00000000 

BYTE_NOT 

4 

00 

ff 

00 

ff 

00 

f  f 

00 

f  f 

00 

ff 

00 

ff 

00 

ff 

00  ff 

WORD_NOT 

5 

0000 

f  ff  f 

0000 

ff  ff 

0000 

f  ff  f 

0000 

f  fff 

QUAD_NOT 

6 

00000000 

f ff ff ff f 

00000000 

ff ff fff f 

BYTE_RAMP 

7 

00 

01 

02 

03 

04 

05 

06 

07 

08 

09 

Oa 

Ob 

Oc 

Od 

Oe  Of 

WORD_RAMP 

8 

0000 

0001 

0002 

0003 

0004 

0005 

0006 

0007 

QUAD_RAMP 

9 

00000000 

00000001 

00000002 

00000003 

BYTE_LFSR 

10 

69 

01 

02 

05 

Ob 

17 

2f 

5e 

bd 

7b 

f  6 

ee 

d8 

bO 

60  cO 

RANDOM 

11 

55 

16 

fc 

d7 

17 

65 

a9 

87 

5f 

44 

be 

5a 

do 

de 

be  a5 

CRPAT 

12 

be 

be 

23 

47 

6b 

8f 

b3 

d7 

fb 

14 

36 

59 

be 

be 

23  47 

CSPAT 

13 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e  7e 

CHALF_SQ 

14 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a  4a 

CQTR_SQ 

15 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78  78 

RDRAM_PAT 

16 

00 

ff 

00 

ff 

00 

f  f 

00 

f  f 

00 

f  f 

00 

ff 

00 

ff 

00  ff 

j  CRPAT 

17 

be 

d7 

23 

47 

6b 

8f 

b3 

14 

5e 

fb 

35 

59 

be 

d7 

23  47 

jCJTPAT 

18 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e  7e 

j CSPAT 

19 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f  7f 

PRED_RAND 

20 

00000000 

11111111 

22222222 

33333333 
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date 


Displays  or  sets  the  switch  date  and  time. 

Synopsis 

date  ["newdate"] 

Availability 

all  users  (display) 

admin  (set) 
Description 

Use  this  command  to  set  the  date  and  time.  All  switches  maintain  the  current  date  and  time  in  flash 
memory.  If  the  security  feature  (secure  mode)  is  not  enabled,  switch  operation  does  not  depend  on  the 
date  and  time.  A  switch  with  incorrect  date  values  continues  to  function  properly.  The  date  and  time  are 
only  used  to  record  events  in  the  various  logs:  for  example,  the  error  log  and  the  port  log. 

To  enable  secure  mode  the  fabric  must  be  synchronized.  Every  switch  in  the  fabric  must  receive  a  fabric 
timestamp  from  the  primary  PCS  switch. 

Use  this  command  with  no  operands  to  display  the  local  switch  date  and  time.  Specify  an  operand  to  set 
the  date  and  time. 

This  command  sets  a  common  date  and  time  for  the  entire  fabric.  If  secure  mode  is  not  enabled,  a  change 
in  date  or  time  to  one  switch  is  forwarded  to  the  principal  switch  and  distributed  to  the  fabric.  If  secure 
mode  is  enabled,  date  or  time  changes  can  be  made  only  on  the  primary  PCS  switch  and  distributed  to 
the  fabric. 

It  might  take  up  to  64  seconds  for  the  switches  in  the  fabric  to  be  synchronized. 

If  the  switches  in  the  fabric  are  v4.1  .x,  v3.1  .x,  or  v2.6.x  or  higher,  this  command  sets  date  and  time  for 
all  switches  in  the  fabric.  If  secure  mode  is  disabled,  a  change  in  date  and  time  to  one  switch  is 
forwarded  to  the  principal  switch  and  distributed  to  the  fabric. 


NOTE:  This  command  becomes  read-only  if  external  NTP  synchronization  is  enabled.  Por  more 
b— I    information,  refer  to  tsClockServer. 


The  date  specified  is  always  the  local  switch  time,  taking  into  account  daylight  saving  time  and  the  time 
zone  setup  of  the  switch.  Each  switch  takes  care  of  converting  the  GMT  time  distributed  fabric-wide  to  its 
local  time.  Refer  to  tsTimeZone  for  more  information  on  time  zone  support. 

The  date  and  time  are  specified  in  the  following  format,  as  used  on  many  UNIX  systems: 

iranddKHMMyy 

where: 

mm  is  the  month,  01  -1 2 
dd  is  the  date,  01-31 
HH  is  the  hour,  00-23 
MM  is  minutes,  00-59 
yy  is  the  year,  00-99 
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If  you  enter  any  value  in  the  range  00-69,  then  the  year  displayed  will  be  2000-2069.  For  example,  if 
you  enter  the  value  04,  then  the  year  displayed  v/ill  be  2004.  If  you  enter  any  value  betv/een  70-99  in  the 
year  field  (yy),  the  year  displayed  v/ill  be  in  the  range  1970-1999.  For  example  if  you  enter  80  for  yy, 
then  the  year  displayed  will  be  1980. 

Operands 

This  command  has  the  following  operand: 

newdate  Specify  the  new  date  and  time,  in  quotation  marks.  This  operand 

is  optional. 

Examples 

To  display  the  current  date  and  time  and  then  modify  it: 


switch :  adinin> 

date 

Fri  Jan  2  9  17 

:  01 : 48 

UTC  2000 

switch ;  adinin> 

date 

"0227123003" 

Thu  Feb  2  7  12 

:30:00 

UTC  2  003 

See  also 

errShow 


portLogShow 
tsClockServer 
tsTimeZone 
upTime 
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dbgShow 

Displays  current  values  of  debug  and  verbosity  levels  of  the  specified  module. 

Synopsis 

dbgshow  module_name 

Availability 

all  users 


Description 

Use  tfiis  command  to  display  the  current  values  of  debug  and  verbosity  levels  of  the  specified  module.  If  no 
module  name  is  specified,  displays  debug  and  verbosity  levels  of  all  modules. 

Operands 

This  command  has  the  follov/ing  operands: 

module_name  Specify  the  name  of  the  module  for  which  you  v/ant  to  view  the 

debug  and  verbosity  levels.  Module  names  are  case  sensitive. 
This  operand  is  optional. 

Examples 

To  display  information  about  a  specific  module  named  NS: 

switch:  admin>  dbgshow  NS 

Module  NS,  debug  level  =  1,  verbose  level  =  1 


See  also 

setDbg 
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diagClearError 

Clears  the  diagnostics  failure  status. 

Synopsis 

diagclearerror   [[--slot]   slotnumber]  -all 

Availability 

admin 

Description 

Use  this  command  to  clear  the  diagnostics  failure  status. 

Operands 

This  command  has  the  following  operands: 

[--slot]   slotnumber       Specify  the  slot  to  clear  the  diagnostics  failure  status.  The  default  is  set 

to  0  and  designed  to  operate  on  fixed-port-count  products. 

-all  If  specified,  all  blades  clear. 

If  no  operand  is  specified,  the  default  is  to  clear  all  bad  port  flags. 

Examples 

To  clear  the  diag  software  flag: 

switch :  adinin>  diagclearerror  1 

Oxlbcb   (fabos) :     Switch:   0,   Error  DIAG-CLEARERR,  3, 
Pt5  Sll  ChO  Qdl  Diagnostics  Error  Cleared 
Err#  0120041  0105 

See  also 

none 
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d  iagCom  ma  ndShow 

Displays  diagnostic  command  descriptions. 

Synopsis 

diagcommandshow  [command] 

Availability 

all  users 

Description 

Use  this  command  to  display  a  short  description  of  a  diagnostic  command. 


j^f  NOTE:    Use  diagHelp  to  look  up  diagnostic  command  help  pages. 
Options 

This  command  has  the  following  options: 
command  Specify  a  command  name  to  display  more  detailed  information. 

Examples 

To  display  a  list  of  diagnostic  commands,  with  descriptions: 


switch : admin>  diagcommandshow 

bladepropshow 

display 

blade  properties 

chippropshow 

display 

chip  properties 

chipregshow 

display 

contents  of  port  registers 

datatypeshow 

display 

available  diagnostic  data  types 

diagcommandshow 

display 

diagnostic  command  descriptions 

diaghelp 

display 

diagnostic  command  descriptions 

diagmodeshow 

display 

diagnostic  mode  configuration 

diagoktorun 

check  to 

see  if  it  is  ok  to  run  a  diagnostic  test 

diagshow 

display 

diagnostics  status 

diagstatus 

display 

currently  running  diagnostic  tests 

itemlist 

diagnostic  list  parameter  syntax  and  grammar 

information 

minispropshow 

display 

mini-switch  ASIC  property 

minisregshow 

display 

contents  of  mini-switch  registers. 

ptbuf show 

dump  port  buffer  contents 

(output  truncated) 

See  also 

diagHelp 
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diagDisablePost 

Disables  power-on  self-test  (POST). 

Synopsis 

diagdisablepost 

Availability 

admin 

Description 

Use  this  command  to  disable  POST.  A  reboot  is  not  required  for  this  command  to  take  effect. 
NOTE:   This  command  disables  POST  on  both  Core  Switch  2/64  logical  switches. 


Operands 


none 


Examples 


To  disable  the  POST  during  future  powerons: 


switch  :adinin>  diagdisablepost 


Config  update  Succeeded 


Diagnostic  POST  is  now  disabled. 


See  also 


diagEnablePost 
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diagEnablePost 

Enables  power-on  self-test  (POST)  execution  at  next  reboot. 

Synopsis 

diagenablepost 

Availability 

admin 

Description 

Use  this  command  to  enable  POST.  A  reboot  is  not  required  for  this  command  to  take  effect.  POST  includes 
two  phases:  POST  Phase  I  mainly  tests  hardware  and  POST  Phase  II  tests  system  functionality. 

"25^)f  NOTE:    This  command  disables  POST  on  both  Core  Switch  2/64  logical  switches. 


Operands 

none 

Examples 

To  enable  the  POST  during  future  powerons: 

switch : admin>  diagenablepost 
Config  update  Succeeded 
Diagnostic  POST  is  now  enabled. 

See  also 

diagDisablePost 
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diagEnv 

Diagnostic  debug  parameters  management  package. 

Synopsis 

diagsetdebug  value 
diagdebughelp 

diagsetdebugnoncheck  value 

diagsetdebugnorestore  value 

diagsetf aillimit  value 

diagsetf rcerr  value 

diagshowusr 

...  more  commands  ... 

Availability 

admin 

Description 

All  of  diagnostic  parameters  can  be  set  either  by  running  relevant  user  commands  or  by  setting  them 
directly  in  some  way.  The  latter  method  is  supposed  to  be  run  only  by  in-house  technicians  but  users. 
Diagnostic  parameters  are  used  primarily  for  debugging  purposes  and  users  should  not  tamper  with  those 
if  not  told  so. 

To  display  the  values  of  diagnostic  parameters,  run  diagshowusr  as  shown  in  the  "Examples"  section. 
For  a  complete  list  of  the  diagenv  commands,  run  diagdebughelp. 

Each  of  these  commands  is  an  alias  that  evaluates  the  output  of  diagenv  to  set  the  diagnostic  parameter 
for  the  current  shell.  For  example  the  following  alias  is  created  to  implement  diagsetdebug. 

function  diagsetdebug   ()    {  eval   'diagenv  write  USR_DEBUG  $*~  } 

These  aliases  are  created  by  diagenv  as  well  by  including  the  following  command  in  the  shell  start-up 
script: 

eval  ~ diagenv  alias" 

For  proper  operation  the  output  diagenv  sends  to  stdout  should  be  processed  by  the  eval  command  to 
set  the  appropriate  variables. 

A CAUTION:  Your  use  of  the  functionality  made  available  through  this  package  is  at  your  sole  risk  and  you 
assume  all  liability  resulting  from  such  use. 


NOTE:   The  effects  of  diagnostic  parameters  might  be  changed  without  notice. 

Operands 

This  command  has  the  following  operand: 

value  Specify  the  value  for  the  relevant  diagnostic  environment  variable. 
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Examples 

To  display  the  values  of  the  diagnostic  parameters: 


switch : admin> 

diagshowusr 

Name 

Environment 

Value 

USR_DILATION 

DIAG_USR_DLY_DILATION 

1 

USR_MEMDLY 

DIAG_USR_MEMDLY 

10 

USR_SEED 

DIAG_USR_SEED 

0x0 

USR_S FECIAL 

DIAG_USR_S FECIAL 

0x0 

(output  truncated) 

See  also 

none 


142   Fabric  OS  commands 


d  lag  Esd  Ports 

Sets  the  ESD  skip-ports  list. 

Synopsis 

diagesdports    [itemlist  \  -show] 

Availability 

admin 

Description 

Use  this  command  to  set  the  ESD  idle  ports  list.  The  list  is  saved  in  flash  memory  and  stays  in  that  mode 
until  the  next  execution  of  diagEsdPorts. 

ESD  idle  ports  are  used  by  several  of  the  functional  test  methods  to  disable  testing  on  the  specified  list  of 
ports  when  ESD  mode  is  enabled  (refer  to  diagsetesdmode).  The  exact  type  of  port  list  and  the  exact 
use  of  this  list  are  determined  by  each  test  method. 

The  mode  becomes  active  as  soon  as  this  command  is  executed;  it  does  not  require  a  reboot  to  take  effect. 

Operands 

This  command  has  the  follov/ing  operands: 

itemlist  Specifies  the  range  of  ports  to  be  set  to  ESD  Idle.  Refer  to 

itemList  for  proper  syntax.  Enclose  space-separated  list  in 
quotation  marks,  such  as  "1-3  5". 

-show  Specifies  this  operand  to  display  ESD  Idle  Ports  list.  This  operand 

is  optional. 

Examples 

To  display  the  ESD  Idle  Ports  list: 

switch :adinin>  diagesdports  -show 
ESD  Idle  Port  list  is  1-8. 

See  also 

itemList 
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diagFailLimit 

Sets  the  diagnostics  fail  limit. 

Synopsis 

diagf aillimit    [limit    |  -show] 

Availability 

admin 

Description 

Use  this  command  to  set  the  diagnostics  fail  limit  to  a  specified  value.  The  fail  limit  controls  the  number  of 
failures  before  certain  diagnostic  test  methods  aborts.  The  exact  use  of  this  configuration  setting  depends 
on  the  test  method. 

The  fail  limit  is  saved  in  flash  memory  and  stays  set  until  the  next  execution  of  diagFailLimit. 

The  new  fail  limit  becomes  active  as  soon  as  this  command  is  executed;  it  does  not  require  a  reboot  to 
take  effect. 

Operands 

This  command  has  the  follov/ing  operands: 

limit  Specify  the  number  of  failures  before  a  diagnostic  test  aborts. 

The  limit  value  must  be  1  or  greater.  This  operand  is  optional. 

-show  Specify  this  operand  to  display  the  current  fail  limit  setting.  This 

operand  is  optional. 

If  no  operand  is  specified,  the  current  value  is  displayed. 

Examples 

To  change  the  fail  limit  from  1  to  5: 

switch : admin>  diagf aillimit  -show 

Fail  Limit  is  1. 

switch :  adinin>  diagf  aillimit  5 

Fail  Limit  is  now  5 . 

Config  update  Succeeded 

See  also 

none 
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diagHelp 

Displays  diagnostic  command  information. 

Synopsis 

diaghelp  [command] 

Availability 

all  users 

Description 

Use  this  command  to  display  a  short  description  of  diagnostic  commands  that  are  available  to  the  user  if 
command  is  not  specified.  The  command  builds  a  database  of  command  information  during  the  first 
execution.  This  process  takes  a  few  seconds  to  complete. 

Operands 

This  command  has  the  following  operand: 

command  Specify  a  command  name  to  display  more  detailed  information. 

Examples 

To  display  diagnostic  command  information: 


switch :  adinin>  diaghelp 

bladepropshow 

display 

blade  properties 

chippropshow 

display 

chip  properties 

chipregshow 

display 

contents  of  port  registers 

datatypeshow 

display 

available  diagnostic  data  types 

diagcommandshow 

display 

diagnostic  command  descriptions 

diaghelp 

display 

diagnostic  command  descriptions 

diagmodeshow 

display 

diagnostic  mode  configuration 

diagoktorun 

check  to 

see  if  it  is  ok  to  run  a  diagnostic  test 

diagshow 

display 

diagnostics  status 

diagstatus 

display 

currently  running  diagnostic  tests 

itemlist 

diagnostic  list  parameter  syntax  and  grammar 

information 

minispropshow 

display  ASIC  pair  property 

minisregshow 

display 

contents  of  ASIC  pair  registers. 

ptbuf show 

dump  port  buffer  contents 

(output  truncated) 

See  also 

none 
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diagLoopId 


Sets  the  diagnostics  loop  ID. 


Synopsis 


diagloopid  [id 


-show] 


Availability 


admin 


Description 


Use  this  command  to  select  the  loop  ID  to  be  used  by  FL  mode  diagnostics.  The  value  entered  will  be 
converted  from  a  loop  ID  to  the  corresponding  AL  PA  and  used  as  the  port  address  for  any  diagnostics 
that  operate  in  FL  Port  mode. 

The  mode  becomes  active  as  soon  as  this  command  is  executed;  it  does  not  require  a  reboot  to  take  effect. 
The  actual  behavior  of  diagLoopid  depends  on  the  test  methods  that  use  it. 

NOTE:    Currently,  no  FL  mode  tests  exist. 


Operands 


This  command  has  the  follov/ing  optional  operands: 


id 


-show 


Specify  the  loop  ID  for  FL_Port  mode  diagnostics. 
Specify  -show  to  display  the  current  loop  ID. 


If  no  operand  is  specified,  the  current  value  is  displayed. 


Examples 


To  display  the  loop  ID: 


switch : admin>  diagloopid  -show 


FL  mode  Loop  ID  is  12  5. 


Notes 


Currently,  no  FL  Port  mode  tests  exist. 
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diagModePr 

Sets  or  displays  diagnostic  print  mode. 

Synopsis 

diagmodepr   [mode   \  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  (1 )  or  disable  print  mode  (0).  The  mode  is  saved  in  flash  memory  until  the 
next  execution  of  diagModePr.  The  mode  becomes  active  as  soon  as  this  command  is  executed;  it  does 
not  require  a  reboot  to  take  effect. 

Print  mode  causes  extra  messages  to  display  in  the  burn-in  and  POST  scripts.  The  exact  behavior  varies, 
depending  on  the  script  being  run. 

Operands 

This  command  has  the  following  optional  operands: 

mode  Specify  1  to  enable,  0  to  disable  print  mode, 

-show  Specify  this  operand  to  display  the  current  mode. 

If  no  operand  is  specified,  the  current  value  is  displayed. 

Examples 


To  enable  print  mode  messages: 

switch :  adinin>  diagmodepr 

-show 

Diagnostic  Print  Mode  is 

currently  disabled. 

switch :  adinin>  diagmodepr 

1 

Config  update  Succeeded 

Diagnostic  Print  Mode  is 

now  enabled. 
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diagModeShow 

Displays  diagnostic  mode  configuration. 

Synopsis 

diagmodeshow 

Availability 

all  users 


Description 

Use  this  command  to  display  the  current  settings  for  several  diagnostic  configuration  parameters.  This 
command  is  most  often  used  by  burn-in  scripts  to  display  a  summary  of  the  configuration  settings  that  were 
in  effect  when  the  script  was  run. 


["2^^  NOTE:    Any  automated  use  of  this  command  only  should  rely  on  the  names  of  the  specific  variables,  not 
on  their  exact  positions  in  the  output.  Earlier  versions  of  this  command  listed 

diag .  mode .  burnin .  nExec  instead  of  Burnin  nExec  and  diag .  mode .  burnin .  nExec  instead  of 
Burnin  passnum. 


Operands 

none 

Examples 

To  display  the  diagnostic  mode: 


switch : admin>  diagModeShow 

diag. mode*  parameters  saved  in  flash: 

diag. mode 

burnin 

=  0 

diag. mode 

burnin . level 

=  0 

diag. mode 

burnin. f irstPowerUp 

=  Thu 

Feb  28  01:36:12  2002 

diag. mode 

esd 

=  0 

diag. mode 

gbic 

=  0 

diag. mode 

splb 

=  0 

diag. mode 

lab 

=  0 

diag. mode 

mf  g 

=  0 

diag. mode 

bplb 

=  0 

diag. ports 

=  TEST  ( 

tYpe=INDEX,    sz=512) :  100. 

Burnin  passnum 

=  1 

Burnin  nExec 

=  0 

Silkworm  Mode 

=  OFF 

Disable  Modes  Print 

=  OFF 
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See  also 

burninLevel 

diagEsdPorts 

setEsdMode 

setGbicMode 

setMf gMode 

setSplbMode 
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diagPost 

Sets  or  displays  diagnostic  POST  configuration. 

Synopsis 

diagpost   [mode   \  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  POST  testing.  The  mode  is  saved  in  flash  memory  (and  stays  in 
that  mode)  until  the  next  execution  of  diagPost.  The  mode  becomes  active  as  soon  as  this  command  is 
executed;  it  does  not  require  a  reboot  to  take  effect. 

POST  mode  modifies  the  behavior  of  the  diagnostics  daemon  program  to  inhibit  testing  of  svvitch  blades 
v/hen  the  system  is  first  pov/ered  on  or  a  new  blade  is  added. 

[2^^  NOTE:    To  enable  or  disable  diagnostic  POST,  the  recommended  method  is  to  use  diagEnablePost 
and  diagDisablePost. 


Operands 

This  command  has  the  following  optional  operands: 

mode  Specify  1  to  enable,  0  to  disable  POST  test, 

-show  Specify  this  operand  to  display  the  current  mode. 

If  no  operand  is  specified,  the  current  value  is  displayed. 

Examples 

To  enable  and  then  disable  the  POST  test: 

switch : admin>  diagpost 

Diagnostic  POST  is  currently  disabled, 
switch : admin>  diagpost  1 
Config  update  Succeeded 
Diagnostic  POST  is  now  enabled. 

See  also 

diagDisablePost 
diagEnablePost 
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diagRetry 

Sets  or  displays  diagnostic  retry  mode. 

Synopsis 

diagretry   [mode   \  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  retry  mode  if  the  mode  value  is  nonzero  and  to  disable  the  retry  mode  if  the 
mode  value  is  0.  The  mode  is  saved  in  flash  memory  (and  stays  in  that  mode)  until  the  next  execution  of 
diagRetry.  The  mode  becomes  active  as  soon  as  this  command  is  executed;  it  does  not  require  a  reboot 
to  take  effect. 

Retry  mode  modifies  the  behavior  of  the  diagnostic  test  methods,  pov/er-on  self-test  (POST),  and  burn-in 
scripts.  The  exact  behavior  depends  on  the  tests  and  scripts  that  are  run. 

Operands 

This  command  has  the  follov/ing  optional  operands: 

mode  Specify  1  to  enable,  0  to  disable  retry  mode. 

-show  Specify  this  operand  to  display  the  current  mode  setting. 

If  no  operand  is  specified,  the  current  value  is  displayed. 

Examples 

To  viev/  the  current  retry  mode  value: 

switch : adinin>  diagretry  -show 

Diagnostic  Retry  Mode  is  currently  enabled. 
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diagSetBurnin 

Initializes  the  blade  for  a  burn-in  run. 


Synopsis 

diagsetburnin   [--slot  slotnumber]  [script   |  -current] 

Availability 

admin 


Description 

This  sets  up  the  blade  burn-in  parameters  for  the  registered  burn-in  script.  The  burn-in  will  start  at  the  next 
run  of  power-on  self-test  (POST)  on  the  designated  blade(s). 

The  errors  and  activity  logs  are  stored  in  flash  memory.  The  activity  log  of  the  script  is  saved  in 
/var/log/scriptname. slot. log.  The  errors  produced  are  available  from  the  burninErrShow  command  on 
a  per-blade  basis.  When  power  cycles  occur,  the  burn-in  activity  is  restarted  at  the  test  that  was  interrupted 
at  the  time  of  the  power  cycle.  This  command  does  not  require  a  reboot  to  take  effect. 


"2^^  NOTE:    Boards  must  be  installed  prior  to  running  this  command  and  diagSetCycle  must  be  run  prior  to 
diagSetBurnin  if  you  want  to  use  both  commands. 


Operands 

This  command  has  the  following  operands: 

--slot  slotnumber  Specify  which  slot  number  to  update.  If  this  option  is  not 

specified  at  all,  then  all  slots  on  the  switch  are  set  up  for  burn-in. 

script  Specify  the  name  of  the  burn-in  script  to  run. 

-current  Set  the  name  of  burn-in  script  to  current  burn-in  script. 

Examples 

To  set  the  burn-in  script  and  mode: 

switch : admin>  diagsetburnin  --slot  1  -current 
existing  script  is:  /f abos/share/switchess . sh 
Burnin  mode  is  Enabled. 

Removing  all  log  files  in  /var/log  for  slot  1 

Slot  1  burnin  name  is  now  /fabos/share/switchess . sh 

Config  update  Succeeded 

See  also 

burninErrShow 
diagSetCycle 
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diagSetCycle 

Sets  diagnostic  script  parameters. 

Synopsis 

diagsetcycle  script   [-show   |    -default   |    [-keyword  value]] 

Availability 

admin 

Description 

Use  this  command  to  provide  an  interactive  method  to  update  diagnostic  command  parameters.  If  only 
script  is  specified,  the  command  displays  all  configuration  variables  used  by  the  specified  script  and  enters 
an  interactive  session.  If  all  parameters  are  used,  variables  can  be  updated  manually. 

In  interactive  mode,  the  current  value,  default  value,  and  description  of  purpose  of  the  variable  are 
displayed  for  each  variable.  If  no  nevv  value  is  specified,  the  current  value  is  left  unchanged.  If  a  new 
value  is  entered,  its  value  is  updated  and  stored  in  the  configuration  database  for  that  blade  type.  This 
command  does  not  require  a  reboot  to  take  effect. 

Operands 

This  command  has  the  following  operands: 

script  Specify  a  script  in  which  you  want  to  change  parameters. 

-show  Specify  this  operand  to  display  the  parameters  for  the  specified 

diagnostic  script. 

-default  Specify  this  operand  to  set  the  script  parameters  to  default 

values. 

-keyword  value  The  script  parameters  can  be  updated  noninteractively  using  this 

style  of  option  list,  value  is  the  keyword  to  update;  the  value 
should  be  specified  manually  in  this  case. 
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Examples 

To  update  diagnostic  command  parameters: 


switch : 

admin>  diagsetcycle 

switchburnin . sh  -show 

CURRENT 

-  KEYWORD  : 

DEFAULT 

1 

-  number_of_runs  : 

1 

2 

-  vib  : 

2 

10 

-  thermal  : 

10 

BURNIN 

-  label  : 

BURNIN 

1 

-  tbr_passes  : 

1 

1 

-  prt_on  : 

1 

1 

-  cntmem_on  : 

1 

1 

-  cmi_on  : 

1 

1 

-  retention_on  : 

1 

1 

-  cam_on  : 

1 

50 

-  flt_passes  : 

50 

25 

-  sta_passes  : 

25 

100 

-  plb_nframes  : 

100 

50 

-  txd_nfraines  : 

50 

200 

-  xpt  nframes  : 

200 

20 

-  bpt_nframes  : 

20 

50 

-  slk_nmegs  : 

50 

30 

-  bpt_all_nf rames : 

30 

50 

-  slk_all_nmegs  : 

50 

See  also 

burninLevel 

diagSetBurnin 

diagStopBurnin 


1 54   Fabric  OS  commands 


diagShow 

Displays  diagnostics  status. 

Synopsis 

diagshow  [--slot  number]  [-uports  itemlist]  [-bports  itemlist]  [-use_bports 
value] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  diagnostics  status  for  the  specified  list  of  blade  or  user  ports. 

Operands 

This  command  has  the  following  operands: 

-slot  number  Specify  which  slot  to  operate  on.  If  this  option  is  not  specified, 

the  default  slot  0  is  used.  The  default  slot  is  designed  to  operate 
on  fixed-port-count  products.  By  default,  this  command  displays 
all  user  ports  in  the  system. 

-uports  itemlist        Specify  a  list  of  user  ports  to  display.  This  operand  is  optional. 

-bports  itemlist       Specify  a  list  of  blade  ports  to  display.  This  operand  is  optional. 

-use_bports  value     If  this  value  is  not  0  the  diagnostics  status  for  the  blade  ports 

specified  in  -use_bports  displays;  otherwise,  the  user  ports 
specified  in  -uports  displays.  The  default  value  is  0.  This 
operand  is  optional. 

Examples 

To  display  diagnostic  status  on  a  switch  blade: 

switch :  adinin>  diagshow 

Diagnostics  Status:     Fri  Feb  08  15:25:24  2002 


Slot: 

1  UPORTS 

Port 

BPort 

Diag 

Active 

Speed 

0 

15 

OK 

UP 

2G 

Auto 

1 

14 

OK 

UP 

2G 

Auto 

2 

13 

OK 

UP 

2G 

Auto 

3 

12 

OK 

UP 

20 

Auto 

4 

31 

OK 

UP 

2G 

Auto 

5 

30 

OK 

UP 

2G 

Auto 

6 

29 

OK 

UP 

20 

Auto 

7 

28 

OK 

UP 

2G 

Auto 

8 

47 

OK 

UP 

2G 

Auto 

(output  truncated) 


See  also 


ItemList 
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diagShowTime 

Sets  or  displays  diagnostic  show-time  mode. 

Synopsis 

diagshowtime   [mode   \  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  show-time  mode  (if  the  mode  value  is  not  0)  or  disable  the  show-time  mode 
(if  the  mode  value  is  set  to  0).  The  mode  is  saved  in  flash  memory  (and  stays  in  that  mode)  until  the  next 
execution  of  diagShowTime.  The  mode  becomes  active  as  soon  as  this  command  is  executed;  it  does  not 
require  a  reboot  to  take  effect. 

Show-time  mode,  when  enabled,  causes  each  test  to  display  elapsed-time  messages.  It  is  normally  used 
during  burn-in  and  for  test  method  debugging. 


NOTE:    diagsetshowtime  is  an  alias  of  diagshowtime. 


Operands 

This  command  has  the  following  optional  operands: 

mode  Specify  1  (or  any  nonzero  value)  to  enable  show-time  mode; 

specify  0  to  disable  show-time  mode. 

-show  Specify  this  operand  to  display  the  current  mode  setting. 

If  no  operand  is  specified,  the  current  value  is  displayed. 

Examples 

To  enable  show-time  mode: 

switch : admin>  diagshowtime 

Show  Time  mode  is  0   (Disabled) . 

switch : admin>  diagshowtime  1 

Config  update  Succeeded 

Show  Time  mode  is  now  1    (Enabled) . 
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diagSilkworm 


Enables  or  disables  silkworm  mode. 


Synopsis 

diagsilkworm   [mode   \  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  silkworm  mode  (if  the  mode  value  is  not  0)  or  disable  the  silkworm  mode  (if 
the  mode  value  is  0).  The  mode  is  saved  in  flash  memory  (and  stays  in  that  mode)  until  the  next  execution 
of  diagSilkworm.  The  mode  becomes  active  as  soon  as  this  command  is  executed;  it  does  not  require  a 
reboot  to  take  effect. 

Silkworm  mode,  when  enabled,  notifies  the  diagnostics  environment  and  test  methods  that  the  tests  are 
running  in  silkworm  mode.  For  proper  operation,  FCSW  mode  also  must  be  disabled. 


\^^}f  NOTE:    This  mode  cannot  be  used  by  burn-in  or  POST  scripts  for  multi-blade  systems  because  it  is  a 


Operands 


This  command  has  the  following  operands: 


mode 


-show 


Specify  1  to  enable  silkworm  mode;  specify  0  to  disable 
silkworm  mode.  This  operand  is  optional. 

Specify  this  operand  to  display  the  current  mode  setting.  This 
operand  is  optional. 


If  no  operand  is  specified,  the  current  value  is  displayed. 


Examples 


To  enable  silkworm  mode: 


switch : adinin>  diagsilkworm  -show 


Silkworm  mode  is  0   (Disabled) . 


Note 


This  mode  might  not  be  used  by  burn-in  or  POST  scripts  for  multiblade  systems  because  it  is  a  switch-wide 
configuration. 
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diagSkipTests 

Enables  or  disables  diagnostics  skip  test  flags. 

Synopsis 

diagskiptests    [value  \  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  the  diagnostics  skip  test  flags.  The  skip  test  flags  are  saved  in  flash 
memory  and  stay  set  until  the  next  execution  of  diagSkipTests. 

The  mode  becomes  active  as  soon  as  this  command  is  executed.  It  does  not  require  a  reboot  to  take  effect. 

The  skip  test  flags  are  used  to  skip  the  execution  of  certain  POSTs  that  might  prove  hazardous  to  normal 
sv/itch  operation.  The  exact  use  of  this  flag  is  determined  by  the  POST  scripts  and  the  specific  test  methods 
used. 

Operands 

This  command  has  the  follov/ing  operands: 

value  Specify  a  bit  mask  for  tests  to  skip. 

-show  If  specified  or  no  value  is  given,  the  current  skip  test  flags 

displays. 

If  no  operand  is  specified,  the  current  value  is  displayed. 

Examples 

To  display  the  current  skip  test  flags: 

switch: admin>  diagskiptests  -show 
Skip  tests  is  1. 
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diagStatus 

Displays  currently  running  diagnostic  tests. 

Synopsis 

diagstatus    [  slotnumber  ] 

Availability 

all  users 

Description 

Use  this  command  to  display  currently  running  diagnostic  test  names. 

Operands 

This  command  has  the  following  optional  operand: 

slotnumber  Specifies  the  slot  to  display.  If  omitted,  all  blades  in  the  system 

are  assumed. 

Examples 

To  display  currently  running  diagnostic  tests: 


switch :adinin>  diagstatus 

Diagnostic  status  for  slot: 

1 . 

Diag  executing  "NONE" 

Diagnostic  status  for  slot: 

2  . 

Diag  executing  "NONE" 

Diagnostic  status  for  slot: 

3  . 

Diag  executing  "NONE" 

Diagnostic  status  for  slot: 

4  . 

Diag  executing  "NONE" 

(output  truncated) 
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diagStopBurnin 

Terminates  a  blade  burn-in  run. 

Synopsis 

diagstopburnin   [--slot  number] 

Availability 

admin 

Description 

Use  this  command  to  determine  which  PID  is  running  burn-in  on  a  blade  and  terminate  that  activity.  The 
burn-in  script  handles  the  logging  cleanup. 

This  command  does  not  require  a  reboot  to  take  effect. 
Operands 

This  command  has  the  following  optional  operand: 

--slot  number  Specify  the  slot  to  stop  burn-in.  If  no  slot  is  specified,  this 

command  executes  on  all  slots  in  the  logical  switch.  This 
operand  is  optional. 

Examples 

To  stop  burn-in  mode  on  a  switch: 


switch : admin>  diagstopburnin  --slot 

1 

No  burn-in  script  active  on  slot  1 

1  burninErrShow  output : 

Oxleea  (fabos):  Dec  19  14:42:18 

Switch:    0,    Error  DIAG-MANUALl ,    1,  " 

1 

Starting 

switchess   . .  . 

Err#   0140042  0100:101:000:001:24:37 

0xc84    (fabos):   Dec  20  08:57:27 

Switch:    0,    Error  DIAG-MANUALl,    1,  " 

1 

switchess 

:  ABORT 

Err#  0140042  0100:101:000:000:25:41 

Oxlbei    (fabos):   Feb  07  19:02:28 

Switch:    0,    Error  DIAG-MANUALl,    1,  " 

1 

Starting 

switchess   . . . 

Err#  0140042  0100:101:000:001:26:39 

0x47ff    (fabos):   Feb  07  21:45:36 

Switch:    0,    Error  DIAG-MANUALl,    1,  " 

1 

switchess 

:  ABORT 

Err#   0140042  0100:101:000:002:26:41 

IN 

See  also 

diagSetBurnin 
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dIsReset 


Disables  the  dynamic  load  sharing  (DLS)  option. 


Synopsis 

dlsreset 

Availability 

admin 

Description 

Use  this  command  to  turn  off  DLS  when  a  fabric  change  occurs.  Refer  to  dlsSet  for  a  full  description  of 
load  sharing. 


\^)f  NOTE:  This  command  should  be  used  only  if  devices  connected  to  the  fabric  cannot  handle  occasional 
C— I    routing  changes  correctly. 


DLS  is  not  supported  in  certain  routing  policies.  Refer  to  aptPolicy  for  more  information  on  routing 
policies. 


Operands 


none 


Examples 


To  disable  the  dynamic  load  sharing  option: 


switch :adinin>  dlsreset 


Committing  configuration ...  done . 


switch : admin>  dlsshow 


DLS  is  not  set 


See  also 


aptPolicy 


dIsSet 


dlsShow 
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dIsSet 


Enables  the  dynamic  load  sharing  (DLS)  option. 

Synopsis 

dlsset 

Availability 

admin 

Description 

Use  this  command  to  turn  on  DLS  when  a  fabric  change  occurs. 

Routing  is  generally  based  on  the  incoming  port  and  the  destination  domain.  This  means  that  all  the  traffic 
coming  in  from  a  port  (either  an  E_Port  or  an  Fx_Port)  directed  to  the  same  remote  domain  is  routed 
through  the  same  output  E_Port. 

To  optimize  fabric  routing,  when  there  are  multiple  equivalent  paths  to  a  remote  switch,  traffic  is  shared 
among  all  the  paths.  Load  sharing  is  recomputed  when  a  switch  is  booted  up  or  every  time  a  change  in 
the  fabric  occurs.  A  change  in  the  fabric  is  defined  as  an  E_Port  going  up  or  down  or  an  Fx_Port  going  up 
or  down. 

During  load  sharing,  recomputation,  existing  routes  might  be  moved  to  maintain  optimal  balance.  This  can 
cause  momentary  frame  loss  along  these  routes. 

In  contrast,  if  DLS  is  turned  off  (using  dlsReset),  load  sharing  calculations  are  used  only  to  place  new 
routes.  Once  placed,  existing  routes  are  never  moved  from  one  output  E  Port  to  another  unless  the  original 
output  E_Port  is  no  longer  a  recognized  path  to  the  remote  domain.  Optimal  balance  is  rarely  achieved 
with  this  setting. 


r2^^  NOTE:  DLS  is  not  supported  in  certain  routing  policies.  Refer  to  aptPolicy  for  more  information  on 
li— I    routing  policies. 


Operands 

none 

Examples 

To  enable  the  dynamic  load  sharing  option: 


switch 

adinin> 

dlsset 

switch 

admin> 

dlsshow 

DLS  is 

set 

See  also 

aptPolicy 

dlsReset 

dlsShow 

iodReset 

iodSet 
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iodShow 

urouteShow 

topologyShow 


Fabric  OS  5.0.0  command  reference  guide   1 63 


dIsShow 

Display  the  setting  of  the  dynamic  load  sharing  (DLS)  option. 

Synopsis 

dlsshow 

Availability 

all  users 

Description 

Use  this  command  to  display  whether  DLS  is  on  or  off.  One  of  two  messages  displays: 

DLS  is  set  The  DLS  option  is  turned  on.  Load  sharing  is  reconfigured  with 

every  change  in  the  fabric,  and  existing  routes  can  be  moved  to 
maintain  optimal  balance. 

DLS  is  not  set  The  DLS  option  is  turned  off.  Once  placed,  existing  routes  are 

never  moved  to  maintain  optimal  balance. 

Refer  to  dlsSet  for  a  description  of  load  sharing. 

Operands 

none 

Examples 

To  display  the  current  DLS  option  setting: 

switch : admin>  dlsshow 
DLS  is  set 


See  also 

dlsSet 
dlsReset 
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dnsConfig 

Sets  or  displays  domain  name  service  (DNS)  parameters. 

Synopsis 

dnsconf ig 

Availability 

admin 

Description 

Use  this  command  to  display  or  set  the  domain  name  service  parameters. 

The  domain  name  service  parameters  are  the  domain  name  and  the  name  server  IP  address  for  primary 
and  secondary  name  servers. 

Operands 

none 

Examples 

To  set  the  DNS  parameters  for  the  system: 


switch :  adinin>  dnsconf  ig 

Enter  option 

1  Display  Domain  Name  Service  (DNS) 

configuration 

2  Set  DNS  configuration 

3  Remove  DNS  configuration 

4  Quit 

Select  an  item:    (1..4)    [4]  2 

Enter  Domain  Name :    [ ]   domain . com 

Enter  Name  Server  IP  address  in  dot 

notation:    []  123 

123 

123 

123 

Enter  Name  Server  IP  address  in  dot 

notation:    []  123 

123 

123 

124 

DNS  parameters  saved  successfully 

Enter  option 

1  Display  Domain  Name  Service  (DNS) 

configuration 

2  Set  DNS  configuration 

3  Remove  DNS  configuration 

4  Quit 

Select  an  item:    (1..4)    [4]  4 
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See  also 

conf igDownload 

conf igUpload 

f irmwareDownload 

ipAddrSet 

ipAddrShow 
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errClear 

Clears  all  error  log  messages  for  all  switch  instances  on  this  control  processor  (CP). 

Synopsis 

errclear 

Availability 

admin 

Description 

Use  this  command  to  clear  all  internal  and  external  error  log  messages  for  all  switch  instances  on  this  CP. 

Operands 

none 

Examples 

To  clear  the  error  log  messages: 

switch : adinin>  errclear 

See  also 

err Dump 
errShow 
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errDelimiterSet 

Sets  the  error  log  start  and  end  delimiter  for  messages  pushed  to  the  console. 

Synopsis 

errdelimiterset    [-s  "start  delimiter  string"]    [-e  "end  delimiter  string"] 

Availability 

admin 

Description 

Use  this  command  to  set  the  error  log  start  and  end  delimiter  for  log  messages  pushed  to  the  console.  A 
colon  (  :  )  is  automatically  applied  to  the  end  of  the  start  delimiter  and  the  beginning  of  the  end  delimiter. 
An  empty  string  clears  the  start  and  the  end  delimiters  (including  the  colon)  so  that  they  are  not  displayed. 

If  no  arguments  are  supplied  to  the  command,  it  instead  displays  the  existing  errDelimiterSet 
configuration.  These  delimiters  are  stored  persistently. 

Operands 

This  command  has  the  following  optional  operands: 

-s  start  delimiter  string        Specifies  the  alphanumeric  string  for  the  start  delimiter; 

up  to  1 0  characters  are  allowed. 

-e  end  delimiter  string  Specifies  the  alphanumeric  string  for  the  end  delimiter; 

up  to  1 0  characters  are  allowed. 

Examples 

To  display  the  start  and  end  delimiter: 

switch : admin>  errdelimiterset 
delimiter  start  string:  <none> 
delimiter  end  string:  <none> 
To  change  the  start  and  end  delimiter  (sample  output): 

switch : admin>  errdelimiterset  -s  "Start"   -e  "End" 

Start:2003/03/10-09:54:03,    [NS-1002],    1035,,    ERROR,    SWITCH43,  Name 
Server  received  an  invalid  request  from  device  10 : 02 : 32 : A3 : 78 : 23 : 23 : End 

See  also 

err Dump 

errFilterSet 

errShow 
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errDump 

Displays  the  error  log,  without  pagination. 

Synopsis 

errdump    [-s  switch_instance]  [-r] 

Availability 

all  users 

Description 

Use  this  command  to  display  external  error  log  messages  for  all  switch  instances  and  the  chassis,  without 
pagination.  The  -r  operand  displays  the  messages  in  reversed  order.  The  following  information  displays 
in  each  message: 

Start  delimiter  Delimiter  string  for  the  start  of  a  message. 

Timestamp  Timestamp  for  the  message. 

Message  ID  Message  identifier. 

External  sequence  number       Sequence  number  for  the  message 

Severity  Severity  of  the  message.  Valid  values  include  INFO,  WARNING, 

ERROR,  and  CRITICAL. 

Switch  name  Switch  name  for  the  generator  of  this  message,  or  "chassis". 

Object  ID  Object  identifier. 

Message  Message  body. 

End  delimiter  Delimiter  string  for  the  end  of  a  message. 

Operands 

This  command  has  the  following  optional  operands: 

-s  Specifies  to  display  messages  only  from  one  switch  instance. 

Valid  values  are  0  or  1.  If  this  option  is  omitted,  messages  from 
all  switch  instances  are  displayed. 

-r  Specifies  to  display  messages  in  reversed  order.  If  this  option  is 

omitted,  the  messages  display  in  the  normal  order. 

Examples 

To  display  the  error  log,  without  pagination: 


switch :user>  errdump 

Version :  4.4.0 

2004/07/14-22:24:08,  [HAMK-1003] 

1, 

INFO, 

switchl,  Heartbeat  up 

2004/07/14-22:24:47,  [FSSM-1002] 

2, 

INFO, 

switchChassis ,  HA 

State  is  in  sync 

2004/07/14-22:25:29,  [SEC-1192], 

3,  , 

INFO, 

switch2.  Security 

violation:  Login  failure  attempt 

via 

SERIAL 
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See  also 

errDelimiterSet 

errFilterSet 

errShow 
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errFilterSet 

Sets  a  filter  for  an  error  log  destination. 

Synopsis 

errFilterSet   [-d  "destination"  -v  "severity"  ] 

Availability 

admin 

Description 

Use  this  command  to  set  a  filter  for  an  error  log  destination.  A  filter  is  set  based  on  tfie  severity  level  of  the 
messages. 

If  no  parameters  are  specified,  this  command  displays  the  filters  that  are  currently  in  use. 

Operands 

This  command  has  the  following  operands: 

-d  "destination"         Specifies  the  destination  to  set  the  filter.  The  "console"  string  is 

the  only  valid  value  at  this  time. 

-V  "severity"  Specifies  the  minimum  severity  of  the  message  to  pass  through 

the  filter.  Valid  values  are  "info",  "warning",  "error",  and 
"critical". 

Examples 

To  display  the  current  filter  settings: 

switch : adinin>  errfilterset 
console:   filter  severity  =  WARNING 
To  set  the  filter  severity  level  for  the  console: 

switch :adinin>  errfilterset  -d  "console"   -v  "WARNING" 

See  also 

err Dump 
errShow 
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errShow 

Displays  the  error  log  messages,  with  pagination. 

Synopsis 

errshow   [-s  switch_instance]  [-r] 

Availability 

all  users 

Description 

Use  this  command  to  display  external  error  log  messages  for  all  switch  instances  and  the  chassis,  one  at  a 
time.  The  -r  operand  displays  the  messages  in  a  reversed  order.  The  following  information  displays  in 
each  message: 


Start  delimiter 

Delimiter  string  for  the  start  of  a  message. 

Timestamp 

Timestamp  for  the  message. 

Message  ID 

Message  identifier. 

External  sequence 

Sequence  number  for  the  message 

number 

Severity 

Severity  of  the  message.  Valid  values  include  INFO,  WARNING, 

ERROR,  and  CRITICAL. 

Switch  name 

Switch  name  for  the  generator  of  this  message,  or  "chassis". 

Object  ID 

Object  identifier. 

Message 

Message  body. 

End  delimiter 

Delimiter  string  for  the  end  of  a  message. 

Operands 

This  command  has  the  following  optional  operands: 

-s  Specifies  to  display  messages  only  from  one  switch  instance. 

Valid  values  are  0  or  1 .  If  this  operand  is  omitted,  messages 
from  all  switch  instances  are  displayed. 

-r  Specifies  to  display  messages  in  reversed  order.  If  this  operand 

is  omitted,  the  messages  display  in  the  normal  order. 
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Examples 

To  display  the  error  log,  with  pagination: 


switch :user>  errshow 
Version:  4.4.0 

2004/07/14-22:24:08,     [HAMK-1003],  1, 

Type  <CR>  to  continue,   Q<CR>  to  stop 

2004/07/14-22:24:47,  [FSSM-1002],  2, 
in  sync 

Type  <CR>  to  continue,   Q<CR>  to  stop 

2004/07/14-22:25:29,  [SEC-1192],  3,, 
Login  failure  attempt  via  SERIAL. 

Type  <CR>  to  continue,   Q<CR>  to  stop 


INFO,   switchl.   Heartbeat  up 


INFO,   switchChassis ,   HA  State  is 


INFO,   switch2 ,  Security  violation: 


See  also 

errDelimiterSet 
err Dump 
errFilterSet 
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exit 

Logs  out  from  a  shell  session. 

Synopsis 

exit 

Availability 

all  users 

Description 

Use  this  command  to  log  out  from  a  telnet,  riogin  or  serial  port  session.  Telnet  and  riogin  connections  are 
closed;  the  serial  port  returns  to  the  login:  prompt. 

The  exit  command  is  an  accepted  synonym  for  logout,  as  is  typing  Ctrl-D  at  the  beginning  of  a  line. 
Operands 

none 

Examples 

To  exit  from  a  shell  session: 

switch : admin>  exit 
Connection  to  host  lost. 

See  also 

logout 
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fabPortShow 


Displays  fabric  port  information. 


Synopsis 

f abportshow   [slotnumber/] portnumber 

Availability 

all  users 

Description 

Use  tfiis  command  to  display  the  contents  of  a  particular  port's  data  and  also  any  pending  commands. 
Tfie  following  information  displays: 


Port 


Displays  the  port  number. 


State 


The  state  of  the  port: 


PO  Port  Offline 

PI  Port  Online 

P2  ELP  ACC  Received 

P3  Link  Reset  Done 

10  Trunk  Initiator:  EMT  Sent 

11  Trunk  Initiator:  ETP  ACC  Received 

12  Trunk  Initiator:  ETP  Sent 

13  Trunk  Initiator:  Link  Reset 
TO  Trunk  Target:  EMT  Received 
Tl  Trunk  Target:  ETP  Received 
T2  Trunk  Target:  Link  Reset 

LD  Dynamic  long  distance:  ECP  sent  or  received 

T3  Trunk  Target:  Link  reset  done  on  slave 

14  Trunk  Initiator:  Link  reset  done  on  slave 


List 


lU  list  pointer 
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Flags 


Port  flags: 


0x00000001 

0x00000002 

0x00000004 

0x00000008 

0x00000010 

0x00000020 

0x00000040 

0x00000080 

0x00000200 

0x00000800 

0x00001000 

0x00002000 

0x00004000 

0x00008000 

0x00010000 

0x00020000 

0x00040000 

0x00080000 

0x00100000 

0x00200000 

0x00400000 

0x00800000 

0x01000000 

0x02000000 

0x040000000 

0x080000000 

0x100000000 

0x200000000 


Slave  connection 

Loopback  connection 

Incompatible  connection 

Overlapping  domains 

Overlapping  zones 

Done  PTIO  iocti 

Sent  an  RJT  to  ELP 

BP  received  from  the  port 

Segmented  by  routing  code 

Zoning  has  completed 

Segmented  by  Platform  Management 

Segmented  due  to  no  license 

Segmented  due  to  E_Port  disabling 

DIA  already  sent  for  that  port 

RDI  already  sent 

Port  is  true  T  port 

Port  received  an  ELP 

Port  received  an  ELP  RJT 

LR  pending  due  to  ELP  RJT  rev 

Received  a  DIA  on  this  port 

Port  is  the  EMT  Initiator 

Security  violation 

Security  incompatibility 

Rev  a  DIA  ACC 

Port  is  security  authenticating 

ECP  RJT  or  retires  exceeded 

Segmented  due  to  duplicated  WWN 

Segmented  due  to  E_Port  isolation 


nbrWWN       Neighboring  switch's  WWN 


nbrPort  Neighboring  switch's  port 


Ir  tid  Link  reset  timer  identifier  and  current  state. 


red_ports        All  E_Ports  that  are  connected  to  the  same  neighboring  switch 


Operands 


This  command  has  the  following  operands: 


slotnumber 


portnumber 


Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director 
2/1 28.  For  all  other  switches,  this  operand  is  not  required.  The 
slot  number  must  be  followed  by  a  slash  (  /  )  and  the  port 
number. 

The  HP  StorageWorks  director  has  a  total  of  1 0  slots.  Slot 
numbers  5  and  6  are  control  processor  (CP)  cards,  and  slots  1 
through  4  and  7  through  1 0  are  port  cards.  There  are  1 6  ports 
on  each  port  card,  counted  from  the  bottom  up,  0  to  15. 

Specify  a  port  number.  Valid  values  for  port  number  vary, 
depending  on  the  switch  type.  This  operand  is  required. 
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Examples 

To  display  fabric  port  information: 


switch :  adinin>  fabportshow  4/14 
Fabric  Port  Information: 


Port:  62 

State:  P3 

List:  0x10068418 

List  Count:  0 

Flags:  0x280120 

nbrWWN:  10 : 00 : 00 : 60 : 69 : 80 : 06 : cf 

red__ports  : 
10  11  62  63 

Open  commands  pending: 
No  commands  pending 


See  also 

portShow 
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fabRetryShow 

Displays  the  retry  count  of  the  fabric  commands. 

Synopsis 

f abretryshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  retry  count  of  the  fabric  commands.  The  SW_ISL  (ISL  ports)  information 
displays  the  retry  count  for  the  following  fabric  commands: 


ELP  Exchange  Link  Parameters 

ELP  Exchange  Link  Parameters 

HA_EFP  Exchange  Fabric  Parameters 

DIA  Domain  Identifier  Assigned 

RDI  Request  Domain  Identifier 

BF  Build  Fabric 

RSCN  Remote  State  Change  Notification 

FWD  Fabric  Controller  Forward 

EMT  Fabric  Controller  Mark  Timestamp 

FTP  Fabric  Controller  Trunk  Parameters 

RAID  Return  Address  Identifier 

GAID  Get  Address  Identifier 

INQ  Inquiry  Command 

ELP_TMR  Used  internally  for  fabric  application  (not  a  SWJSL) 

ORE  Get  Route  Entry 

ECP  Exchange  Credit  Parameters 

FWN  Firmware  Notification 


Operands 

none 
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Examples 

To  display  the  retry  count  of  Fabric  OS  commands: 


switch :user> 

f abretryshow 

E_Ports 

SW_ISL 

21 

31 

40 

44 

ELP 

0 

0 

0 

0 

EFP 

0 

1 

0 

0 

HA_EFP 

0 

0 

0 

0 

DIA 

0 

0 

0 

0 

RDI 

0 

0 

0 

0 

BF 

0 

0 

0 

0 

RSCN 

0 

0 

0 

0 

FWD 

0 

0 

0 

0 

EMT 

0 

0 

0 

0 

FTP 

0 

0 

0 

0 

RAID 

0 

0 

0 

0 

GAID 

0 

0 

0 

0 

INQ 

0 

0 

0 

0 

ELP_TMR 

0 

0 

0 

0 

GRE 

0 

0 

0 

0 

ECP 

0 

0 

0 

0 

FWN 

0 

0 

0 

0 

See  also 

f abStatsShow 
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fabricPrincipal 

Sets  principal  switch  selection  mode. 

Synopsis 

f abricprincipal    [-fhq] [  mode  ] 

Availability 

all  users  (display  current  setting) 

admin  (modify  current  setting) 
Description 

Use  this  command  to  set  principal  switch  selection  mode  for  the  switch. 

The  implementation  of  the  fabricPrincipal  command  is  based  solely  on  mechanisms  specified  in  the 
Fibre  Channel  standards.  These  mechanisms  provide  a  preference  for  a  switch  requesting  to  be  the 
principal  switch  in  a  fabric,  but  they  do  not  provide  an  absolute  guarantee  that  a  switch  requesting  to  be 
the  principal  switch  will  actually  achieve  this  status. 

When  dealing  with  larger  fabrics,  the  selection  of  the  principal  switch  is  less  deterministic.  In  these  cases, 
to  help  ensure  that  the  desired  switch  is  selected  as  the  principal  switch,  a  small  selection  of  switches 
should  be  connected  together  first,  followed  by  the  addition  of  the  rest  of  the  fabric. 

Operands 

This  command  has  the  following  operands: 

-f  Specify  the  -f  option  to  force  a  fabric  rebuild.  This  option  is 

required  when  enabling  principal  switch  mode. 

-h  Specify  the  -h  option  to  display  command  usage  summary. 

-q  Specify  the  -q  option  to  display  the  current  mode  state. 

mode  Specify  1  to  enable,  or  0  to  disable  principal  switch  mode  (the 

mode  activates  when  the  fabric  rebuilds).  This  operand  is 
optional. 

Examples 

To  display  the  current  mode  setting: 

switch : admin>  f abricprincipal  -q 
Principal  Selection  Mode:  Enable 

To  disable  the  mode  setting: 

switch : admin>  f abricprincipal  0 
Principal  Selection  Mode  disabled 

To  enable  the  mode  setting: 

switch : admin>  f abricprincipal  1 
Principal  Selection  Mode  enabled 
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To  enable  the  mode  setting  and  force  fabric  rebuild: 


switch : adinin>  f abricprincipal  -f  1 

Principal  Selection  Mode  enabled  (Forcing  fabric  rebuild) 

See  also 

f abricShow 
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fabricShow 

Displays  fabric  membership  information. 

Synopsis 

f abricshow 

Availability 

all  users 

Description 

Use  this  command  to  display  information  about  switches  in  the  fabric. 

If  the  switch  is  initializing  or  disabled,  the  message  no  fabric  is  displayed.  If  the  fabric  is  reconfiguring, 
some  or  all  switches  might  not  display;  otherwise,  the  following  fields  display: 

Switch  ID  The  switch  Domain_ID  and  embedded  port  D_ID 

World  Wide  Name  The  switch  WWN 

Enet  IP  Addr  The  switch  Ethernet  IP  address 

PC  IP  Addr  The  switch  PC  IP  address 

Name  The  switch  symbolic  name.  An  arrow  (>)  indicates  the  principal 

switch. 


Operands 

none 

Examples 

The  following  example  illustrates  a  fabric  of  four  switches.  "swl80"  is  the  principal  switch.  Three  of  the 
switches  are  configured  to  run  IP  over  Fibre  Channel. 

switch : admin>  f abricshow 

Switch  ID      Worldwide  Name  Enet  IP  Addr        FC  IP  Addr  Name 


64: 

f f fc40 

10 

00 

00 

60 

59 

00 

06 

56 

192 

168 

64 

59 

192 

168 

65 

59 

"  sw5 " 

65  : 

f ffc41 

10 

00 

00 

60 

69 

00 

02 

Ob 

192 

168 

64 

180 

192 

168 

65 

180 

>" swl80 

66  : 

f ffc42 

10 

00 

00 

60 

69 

00 

05 

91 

192 

168 

64 

60 

192 

168 

65 

60 

" sw60 " 

67  : 

f ffc43 

10 

00 

00 

60 

69 

10 

60 

If 

192 

168 

64 

187 

0.0 

0.0 

" swl87 

The  Fabric  has  4  switches 


See  also 

switchShow 
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fabStateClear 

Clears  the  fabric  state  information. 

Synopsis 

f abstateclear 

Availability 

admin 

Description 

Use  this  command  to  clear  the  queue  of  fabric  state  information  logged  by  the  fabric. 

Operands 

none 

Examples 

To  clear  the  fabric  state  information: 


switch : adinin>  fabstateshow 
Time  Stamp     Input  and  *Action 

S,  P 

Sn,  Pn 

Port 

Xid 

11955 

:  655 

SCN  Switch  Online 

F2  ,NA 

F2,NA 

NA 

NA 

11955 

:  657 

*Start  2  *  F_S_TOV  Timer 

F2  ,NA 

F2,NA 

NA 

NA 

11955 

:  657 

*Start  60  *  F_S_TOV  Timer 

F2  ,NA 

F2,NA 

NA 

NA 

11955 

:  669 

RSCN  Rev  addr:  0x3000000 

F2  ,NA 

F2,NA 

NA 

NA 

11957 

:  65 

SCN  Port  Online 

F2  ,  PO 

F2  ,  PI 

21 

NA 

11957 

:  69 

*ELP  Send 

F2  ,  PI 

F2  ,  PI 

21 

0x2  77 

11957 

:  69 

SCN  Port  Online 

F2  ,  PO 

F2  ,  PI 

44 

NA 

11957 

:75 

*ELP  Send 

F2  ,  PI 

F2  ,  PI 

44 

0x2  7  9 

11957 

:  77 

ELP  Receive 

F2  ,  PI 

F2  ,  PI 

44 

0x2  77 

11957 

:78 

*ELP  Sending  ACC 

F2  ,  PI 

F2  ,  P2 

44 

0x2  77 

11957 

:  82 

ELP  Receive 

F2  ,  PI 

F2  ,  PI 

21 

0x2  7  9 

11957 

:  83 

*ELP  Sending  ACC 

F2  ,  PI 

F2  ,  P2 

21 

0x2  7  9 

11957 

:  87 

ELP  ACC  Receive 

F2  ,  P2 

F2  ,  P2 

21 

0x2  77 

switch :admin>  f abstateclear 

switch :admin>  fabstateshow 

Time 

Stamp 

Input  and  *Action 

S,  P 

Sn,  Pn 

Port 

Xid 

See  also 

f abStatsShow 
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fabStateShow 

Displays  the  fabric  state  information. 

Synopsis 

f abstateshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  queue  of  fabric  state  information  logged  by  the  fabric. 

Operands 

none 

Examples 

To  display  the  fabric  state  information: 


switch : admin>  f abstateshow 
Time  Stamp     Input  and  *Action 

S,  P 

Sn,  Pn 

Port 

Xid 

11955 

:655 

SCN  Switch  Online 

F2,NA 

F2 

NA 

NA 

NA 

11955 

:657 

*Start  2  *  F_S_TOV  Timer 

F2,NA 

F2 

NA 

NA 

NA 

11955 

:657 

*Start  60  *  F_S_TOV  Timer 

F2,NA 

F2 

NA 

NA 

NA 

11955 

:669 

RSCN  Rev  addr:   0x3  00000  0 

F2,NA 

F2 

NA 

NA 

NA 

11957 

:65 

SCN  Port  Online 

F2  ,  PO 

F2 

PI 

21 

NA 

11957 

:69 

*ELP  Send 

F2  ,  PI 

F2 

PI 

21 

0x2  7  7 

11957 

:69 

SCN  Port  Online 

F2  ,  PO 

F2 

PI 

44 

NA 

11957 

:75 

*ELP  Send 

F2  ,  PI 

F2 

PI 

44 

0x2  7  9 

11957 

:77 

ELP  Receive 

F2  ,  PI 

F2 

PI 

44 

0x2  7  7 

11957 

:78 

*ELP  Sending  ACC 

F2  ,  PI 

F2 

P2 

44 

0x2  7  7 

11957 

:82 

ELP  Receive 

F2  ,  PI 

F2 

PI 

21 

0x2  7  9 

11957 

:83 

*ELP  Sending  ACC 

F2  ,  PI 

F2 

P2 

21 

0x2  7  9 

11957 

:87 

ELP  ACC  Receive 

F2  ,  P2 

F2 

P2 

21 

0x2  7  7 

11957 

:92 

ELP  ACC  Receive 

F2  ,  P2 

F2 

P2 

44 

0x2  7  9 

11957 

:94 

SCN  AC_PORT 

F2  ,  P2 

F2 

P3 

44 

NA 

11957 

:99 

SCN  AC_PORT 

F2  ,  P2 

F2 

P3 

21 

NA 

11957 

:106 

SCN  AC_PORT 

F2  ,  P3 

F2 

P3 

21 

NA 

11957 

:106 

SCN  AC_PORT 

F2  ,  P3 

F2 

P3 

44 

NA 

11957 

:364 

SCN  Port  Online 

F2  ,  PO 

F2 

PI 

31 

NA 

11957 

:366 

*ELP  Send 

F2  ,  PI 

F2 

PI 

31 

Ox27b 

11957 

:382 

ELP  ACC  Receive 

F2  ,  PI 

F2 

P2 

31 

0x2  7b 

11957 

:404 

SCN  AC_PORT 

F2  ,  P2 

F2 

P3 

31 

NA 

11957 

:406 

*EFP  Send 

F2  ,  P3 

F2 

P3 

31 

0x2  7  c 

(continued  on  next  page) 
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1  1  Q  C  7  . 

■  /I  7  /I 

.  ^  o 

tpo  tdt 

TPO  0"^ 
r  Z  ,  Jr  O 

7  1 
J  X 

UXZ  /  C 

1  1  Q  c  7  , 

±  ±  y  J  /  , 

■    1  /I 
.  D  ± 

COAT    TP  TDO'D'Ti 

TPO  TDT 

TPO  0"^ 
Jr  Z  ,  Jr  o 

o  X 

1\T  A 

I  I  Q  c  7  . 

■  Q  P  7 

Oi^lN    UUIUci-LIl           X  ticiOIlclJJX  t; 

TP  9  TvTA 

TP  9  l\TZi 

Jr  z  , 

T  T  Q  C  Q  , 

ELP  RgCGIVS 

tp9  on 

tp9  on 
Jr  Z  ,  Jr  U 

A  n 

UXXDD 

1  -1  Q  C  Q  , 

±  ±  y  o  o  . 

■  /I  7 

.  4t  J  O 

tpo  on 

TP9  09 
Jr  Z  ,  JrZ 

/I  n 

n-v-1  Kl"! 

±  ±  J  O  o  . 

■  A  ^  7 

tp9  on 

TP9  01 
jr  Z  ,  ir  X 

9  R 
Z  J 

1  1  Q  R  P  ■ 

±  ±  y  J  o  . 

.  4t  o  D 

ol^lM   JrUKi 

TP9  09 
r  Z  /  JrZ 

TP9  0*5 
Jr  Z  ,  Jr  o 

/I  n 

1\T  A 

±  ±  y  J  o  . 

■  /I  7 

Jir  Jr  oSnci 

TP9  OT 
r  Z  ,  Jr  J 

TP9  0*5 
Jr  Z  ,  Jr  o 

/I  n 
'y:  u 

n-v-9  Q  A 

UXZ  y  4± 

±  ±  y  o  o  . 

■  /I  Q  7 

TP9  OT 

TP9  O"^ 
Jr  Z  ,  Jr  o 

A  n 

n-v-9  Q  /I 
UXZ  y  4t 

T  -]  Q  c  p  , 
X  ±  y  D  O  . 

■  /I  Q  Q 
.  'i  y  y 

oUiNi   irox  c   d-xx  ea.u.y   uiixxrie        JdAJJ  I  1 

TP9  OT 

TP9  O"^ 

Jr  Z  ,  Jr  o 

/I  n 

1\T  A 

I  I  Q  C  p  , 

±  ±  y  D  o  . 

.  J  u  ± 

TP9  OT 

TP9  0*5 
Jr  Z  ,  Jr  o 

/I  n 

1\T  A 

11958 

:  502 

EFP  Receive 

F2  ,  P3 

F2,  P3 

40 

Oxlbd 

11958 

:504 

*EFP  Sending  ACC 

F2  ,  P3 

F2,  P3 

40 

Oxlbd 

11958 

:  907 

RSCN  Rev  addr:  0x1019900 

F2  ,NA 

F2,NA 

NA 

NA 

(output  truncated) 

See  also 

f abPortShow 
f abStateClear 
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fabStatsShow 

Displays  the  fabric  statistics. 

Synopsis 

f abstatsshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  statistics  for  the  fabric.  The  information  displays  as  follows: 

•  Number  of  times  a  switch  domain  ID  has  been  forcibly  changed 

•  Number  of  E_Port  offline  transitions 

•  Number  of  fabric  reconfigurations 

•  Number  of  fabric  segmentations  due  to: 

•  Loopback 

•  Incompatibility 

•  Overlap 

•  Zoning 

•  E  Port  segment 

•  Licensing 

•  Disabling  E  Port 

•  Platform  DB 

•  Security  incompatibility 

•  Security  violation 

•  ECP  error 

•  Duplicate  WWN 

•  E_Port  isolated 

Operands 

none 
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Examples 

To  display  the  fabric  statistics: 


switch : adinin>  fabstatsshow 

Description 

Count 

Domain  ID  forcibly  changed: 

0 

E_Port  offline  transitions: 

0 

Reconfigurations : 

1 

Segmentations  due  to: 

Loopback : 

6  < 

Incompatibility : 

0 

Overlap : 

0 

Zoning : 

0 

E_Port  Segment : 

0 

Licensing : 

0 

Disabled  E_Port : 

0 

Platform  DB : 

0 

Sec  Incompatibility: 

0 

Sec  Violation: 

0 

ECP  Error: 

0 

Duplicate  WWN: 

0 

Eport  Isolated: 

0 

See  also 

f abRetryShow 
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fabSwitchShow 

Displays  the  fabric  switch  state  structure  information. 

Synopsis 

f abswitchshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  fabric  switch  state  structure  information. 


rlH^  IMPORTANT:  This  command  is  provided  strictly  for  debugging  purposes;  it  is  not  intended  as  a  user 
t_l  command. 


Operands 

none 

Examples 

To  display  fabric  switch  state  structure: 


switch : admin>  f abswitchshow 

Fabric  Switch  State 

Structure  Information 

State: 

DO 

Stage : 

warm  done 

Rdi  Receive  Timer: 

0x10069400,    IDLE  STATE 

Unconfirmed  Sw  Timer 

:      0x10069508,    IDLE  STATE 

NTP  Timer: 

0xl00695b8,    IDLE  STATE 

ME  Timer : 

0x10069610,    IDLE  STATE 

Principal  Domain: 

2 

Upstream  Port: 

64 

Principal  Wwn: 

10:00:00:60:69:80:06:ce 

Principal  Priority: 

0x2 

Flags : 

0x40 

me  retry  count : 

0 

inq_sem  count : 

1 

dbg_sem  count: 

1 

ha  efp  count: 

0 

f ab_q  current  count : 

0 

f ab_q  high  water : 

8 

f ab_q  age : 

0  (sec) 

(continued  on  next  page) 
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(J-Uy    JvXCl               U.-L  i  fc:li'--fc:=  . 

0 

X  U.    IlLJU-fcio     (J  U.  U  o  UctliCi-LIiy 

n 

u 

z 

r  WIN      J_iC±lLlt=0  JJt:IiU.J.Iiy 

n 
u 

"F  ^  l^T — ii"  "Inodinoc:!- 
-LctlJ-L -L  t--     ± -LC  fciliofc;  . 

TRUE 

fabric  EFP  version: 

7 

last  message: 

20:30:29.826  *Snd  inquiry  (4) 
NA 

DO , NA     DO , NA  NA 

NTP  ports  online: 

RSCN  domain  recovery 

list: 

no  domain  RSCN's  to  recover 

reachable  domains : 

13  4 

3  domains  reachable 

Ports  used  for  EFP/BF/DIA  flood: 

{ output  truncated) 

See  also 

supportShow 
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fanDisable 

Disables  a  fan  unit. 

Synopsis 

fandisable  unit 

Availability 

admin 

Description 

Use  this  command  to  disable  a  nonfaulty  fan  unit  by  setting  the  RPM  speed  to  0. 

["2^^  NOTE:    This  command  is  not  available  on  nonbladed  systems  excpet  for  the  HP  StorageWorks  SAN 
Switch  4/32. 


Operands 

This  command  has  the  following  operand: 

unit  Specify  the  fan's  unit  number.  View  the  fan  unit  numbers  using 

the  f  anShow  command.  This  operand  is  required. 

Examples 

To  disable  a  fan  unit: 

switch : admin>  fandisable  1 

Fan  unit  1  has  been  disabled 

See  also 

f anEnable 
f anShow 
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fanEnable 

Enables  a  fan  unit. 

Synopsis 

fanenable  unit 

Availability 

admin 

Description 

Use  this  command  to  return  the  fan  unit  to  the  default  RPM  speed  (only  if  the  fan  unit  has  been  previously 
disabled  using  the  f  anDisable  command). 

["2^^  NOTE:    This  command  is  not  available  on  nonbladed  systems  except  for  the  StorageWorks  SAN  Sv/itch 
4/32. 


Operands 

This  command  has  the  follov/ing  operand: 

unit  Specify  the  fan's  unit  number.  Viev/  the  fan  unit  numbers  using 

the  f  anShow  command.  This  operand  is  required. 

Examples 

To  enable  a  fan  that  has  been  disabled: 

switch :  adinin>  fanenable  1 

Fan  unit  1  has  been  enabled 

See  also 

f anDisable 
f anShow 
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fanShow 

Displays  fan  status  and  speed. 

Synopsis 

f anshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  status  and  speed  of  each  fan  in  the  system. 

Fan  status  is  displayed  as: 

OK  Fan  is  functioning  correctly, 

absent  Fan  is  not  present. 

below  minimum  Fan  is  present  but  rotating  too  slowly  or  stopped. 

above  minimum  Fan  is  rotating  too  quickly. 

unknown  Unknown  fan  unit  installed. 

faulty  Fan  has  exceeded  hardware  tolerance. 


NOTE:   The  output  from  this  command  varies  depending  on  switch  type  and  number  of  fans  present. 


Operands 

none 

Examples 

To  display  the  status  and  RPMs  for  the  fans: 


switch 

admin> 

f anshow 

Fan  #1 

is  OK, 

speed  is 

2721 

RPM 

Fan  #2 

is  OK, 

speed  is 

2721 

RPM 

Fan  #3 

is  OK, 

speed  is 

2657 

RPM 

See  also 

chassisShow 
f anDisable 
f anEnable 
psShow 
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fastBoot 

Reboots  the  control  processor  (CP),  bypassing  power-on  self-test  (POST). 

Synopsis 

f astboot 

Availability 

admin 

Description 

Use  this  command  to  reboot  the  CP.  The  reboot  takes  effect  immediately  as  the  CP  resets  and  executes 
normal  power-on  booting  sequence.  However,  POST  is  skipped,  reducing  boot  time  significantly. 

If  POST  has  been  disabled  using  the  diagDisablePost  command,  then  fastBoot  is  the  same  as 

reboot. 

Operands 

none 

Examples 

To  perform  a  reboot  without  executing  POST: 

switch :admin>  f astboot 

See  also 

diagDisablePost 

diagEnablePost 

reboot 
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faZoneAdd 

Adds  a  member  to  a  Fabric  Assist  zone. 

Synopsis 

fazoneadd  "  fazoneName"," member;  member" 

Availability 

admin 

Description 

Use  this  command  to  add  one  or  more  members  to  an  existing  Fabric  Assist  zone. 

This  command  does  not  change  the  defined  configuration  (which  you  can  view  using  the  cfgShow 
command)  until  the  cfgSave  command  is  issued.  For  the  change  to  become  effective,  an  appropriate 
Fabric  Assist  zone  configuration  must  be  enabled  using  the  cfgEnable  command.  For  the  change  to  be 
preserved  across  switch  reboots,  it  must  be  saved  to  flash  memory  using  the  cf  gSave  command. 

NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  required  operands: 

fazoneName  Specify  the  name  of  the  Fabric  Assist  zone,  in  quotation  marks. 

member  Specify  a  list  of  Fabric  Assist  zone  members.  The  whole  list  must 

be  enclosed  in  quotation  marks  and  members  separated  by 
semicolons.  A  member  can  be  specified  by  one  or  more  of  the 
following  methods: 

•  Enter  a  fabric  domain  and  area  number  pair  (for  example, 
"l ,2").  View  the  area  numbers  for  ports  using  the 
switchShow  command. 

•  WWNs  (for  example,  "10  :  49  :  00  :  00  :  00  :  20  :  3f  :  2e"). 
Refer  to  f  aZoneCreate  for  more  details  on  the  use  of 
WWNs  in  Fabric  Assist  zones. 

•  Fabric  Assist  zone  alias  names. 

•  Exactly  one  Fabric  Assist  host  member  (for  example, 

"H{1,2}"). 

Examples 

To  add  aliases  for  some  disk  arrays  to  "Blue_f  azone": 

switch : admin>  fazoneadd  "Blue_f azone" ,    "array3;   arraY4;  arrayS" 

To  add  a  Fabric  Assist  host  member  to  "Blue_f  azone": 

switch : admin>  fazoneadd  "Blue_f azone" ,  "H(5,6}" 
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To  add  another  target  member  to  "Blue_f  azone": 

switch :adinin>  fazoneadd  "Blue_fazone" ,    " 10 : 49 : 00 : 00 : 00 : 2 0 : 3 f : 2e " 

See  also 

f aZoneCreate 
f aZoneDelete 
f aZoneRemove 
f aZoneShow 
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faZoneCreate 


Creates  a  Fabric  Assist  zone. 


Synopsis 


fazonecreate   fazoneName',  member;  member 


Availability 


admin 


Description 


Use  this  command  to  create  a  new  Fabric  Assist  zone.  You  must  specify  a  name  and  member  list.  The  FA 
zone  name  must  be  unique  among  all  Fabric  Assist  zone  objects.  The  member  list  must  be  enclosed  in 
quotation  marks  members  separated  by  a  semicolons. 

A  Fabric  Assist  zone  name  is  in  C  language  style.  It  must  begin  with  a  letter  and  be  followed  by  any 
number  of  letters,  digits,  and  underscore  characters.  Names  are  case  sensitive;  for  example,  "zone_l" 
and  "fazone_l"  are  different  Fabric  Assist  zones.  Spaces  are  ignored. 

The  Fabric  Assist  zone  member  list  must  have  at  least  one  FA  host  and  one  target  member.  Empty  lists  are 
not  allowed. 

When  a  Fabric  Assist  zone  member  is  specified  by  physical  fabric  port  number,  then  all  devices  connected 
to  that  port  are  in  the  Fabric  Assist  zone.  If  this  port  is  an  arbitrated  loop,  then  all  devices  on  the  loop  are 
in  the  Fabric  Assist  zone. 

WWNs  are  specified  as  eight  hex  numbers  separated  by  colons,  for  example, 

"10:00:00:60:69:00:00:  8a".  Zoning  has  no  knowledge  of  the  fields  within  a  WWN;  the  eight  bytes 
are  simply  compared  with  the  node  and  port  names  presented  by  a  device  in  a  login  frame  (FLOGI  or 


When  a  Fabric  Assist  zone  member  is  specified  by  node  name,  then  all  ports  on  that  device  are  in  the 
Fabric  Assist  zone.  When  a  Fabric  Assist  zone  member  is  specified  by  port  name,  only  that  single  device 
port  is  in  the  Fabric  Assist  zone.  Zone  alias  names  have  the  same  format  as  Fabric  Assist  zone  names  and 
are  created  with  the  aliCreate  command.  The  alias  must  resolve  to  a  list  of  one  or  more  physical  fabric 
port  numbers,  WWNs,  or  a  Fabric  Assist  host. 

A  Fabric  Assist  host  member  is  defined  by  wrapping  the  physical  fabric  port  or  a  physical  device  (a 
WWN)  between  "h{"  and  "}".  For  example,  "h{5,  6}"  or  "h{10  :  00  :  00  :  60  :  69  :  00  :  00  :  8a}"  is  a 
Fabric  Assist  host.  The  type  of  Fabric  Assist  zone  members  used  to  define  a  Fabric  Assist  zone  might  be 
mixed  and  matched.  For  example,  a  Fabric  Assist  zone  defined  with  the  following  members  "2  , 12  ; 
2  , 14;  10:00:00:60:69:00:00:  8a"  would  contain  devices  connected  to  switch  2,  ports  1  2  and  14, 
and  the  device  with  a  WWN  of  "10  :  00  :  00  :  60  :  69  :  00  :  00  :  8a"  (either  node  name  or  port  name: 
whichever  port  in  the  fabric  it  is  connected  to.) 

This  command  does  not  change  the  defined  configuration  (which  you  can  view  using  the  cf  gShow 
command)  until  the  cf  gSave  command  is  issued.  For  the  change  to  become  effective,  an  appropriate 
Fabric  Assist  zone  configuration  must  be  enabled  using  the  cfgEnable  command.  For  the  change  to  be 
preserved  across  switch  reboots,  it  must  be  saved  to  flash  memory  using  the  cf  gSave  command. 


NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


PLOGI). 


1 96   Fabric  OS  commands 


Operands 

The  following  operands  are  required: 

fazoneName  Specify  a  name  for  the  Fabric  Assist  zone.  The  name  must  be 

enclosed  in  quotation  marks. 

member  Specify  a  member  or  list  of  members  to  add  to  a  Fabric  Assist 

zone.  The  list  must  be  enclosed  in  quotation  marks,  members 
separated  by  semicolons.  A  member  can  be  specified  by  one  or 
more  of  the  following  methods: 

•  Enter  a  fabric  domain  and  area  number  pair  (for  example, 
"l ,  2").  View  the  area  numbers  for  ports  using  the 
switchShow  command. 

•  WWNs  (for  example,  "10  :  49  :  00  :  00  :  00  :  20  :  3f  :  2e"). 

•  Fabric  Assist  zone  alias  names. 

•  Exactly  one  Fabric  Assist  host  member  (for  example, 

"h{1,  2}"). 

Examples 

To  create  three  Fabric  Assist  zones  using  a  mixture  of  port  numbers  and  Fabric  Assist  zone  aliases: 


switch: 

:  adinin> 

f azoneCreate 

"Red_fazone" , 

"H{1,0};  loopl" 

switch; 

:  adinin> 

f azoneCreate 

"Blue_f azone" , 

" H { 1 , 1 } ;   arrayl ;  1,2; 

array2 " 

switch; 

:  ad[nin> 

f azoneCreate 

"Green_f azone " 

,    "1,0;    loopl;  H{1,2}; 

array2 " 

See  also 

f aZoneAdd 
f aZoneDelete 
f aZoneRemove 
f aZoneShow 
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faZoneDelete 

Deletes  a  Fabric  Assist  zone. 

Synopsis 

f azonedelete "  fazonename" 

Availability 

admin 

Description 

Use  this  command  to  delete  an  existing  Fabric  Assist  mode  zone  on  a  fabric. 

This  command  does  not  change  the  defined  configuration  (which  you  can  view  using  the  cfgShow 
command)  until  the  cfgSave  command  is  issued.  For  the  change  to  become  effective,  an  appropriate 
Fabric  Assist  zone  configuration  must  be  enabled  using  the  cfgEnable  command.  For  the  change  to  be 
preserved  across  switch  reboots,  it  must  be  saved  to  flash  memory  using  the  cf  gSave  command. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Operands 

The  following  operand  is  required: 

fazonename  Specify  the  name  of  the  zone  to  be  deleted,  in  quotation  marks. 

Examples 

To  delete  a  Fabric  Assist  zone: 

switch : admin>  fazonedelete  "Blue_f azone" 

See  also 

f aZoneAdd 
f aZoneCreate 
f aZoneRemove 
f aZoneShow 
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faZoneRemove 

Removes  members  from  a  Fabric  Assist  mode  zone. 

Synopsis 

fazoneremove  " fazoneName",  "member;  member  .  .  ." 

Availability 

admin 

Description 

Use  this  command  to  remove  one  or  more  members  from  an  existing  Fabric  Assist  zone. 

Eacfi  deleted  member  must  be  found  by  an  exact  string  matcfi.  Order  is  important  v/hen  removing  multiple 
members  of  a  Fabric  Assist  zone.  For  example,  if  a  Fabric  Assist  zone  contains  "array2  ;  arrayS  ; 
array4",  removing  "array4;   array3"  fails  but  removing  "array3  ;   array4"  succeeds.  If  issuing 
this  command  results  in  all  members  being  removed,  the  Fabric  Assist  zone  is  deleted. 

This  command  does  not  change  the  defined  configuration  (which  you  can  view  using  the  cfgShow 
command)  until  the  cf  gSave  command  is  issued.  For  the  change  to  become  effective,  an  appropriate 
Fabric  Assist  zone  configuration  must  be  enabled  using  the  cf  gEnable  command.  For  the  change  to  be 
preserved  across  switch  reboots,  it  must  be  saved  to  flash  memory  using  the  cf  gSave  command. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

The  following  operands  are  required: 

fazoneName  Specify  a  name  for  the  Fabric  Assist  zone,  in  quotation  marks. 

member  Specify  a  member  or  list  of  members  to  remove  from  a  Fabric 

Assist  zone.  The  list  must  be  enclosed  in  quotation  marks, 
members  separated  by  semicolons.  A  member  can  be  specified 
by  one  or  more  of  the  following  methods: 

•  Enter  a  fabric  domain  and  area  number  pair  (for  example, 
"l,  2").  View  the  area  numbers  for  ports  using  the 
switchShow  command. 

•  WWNs  (for  example,  "10  : 49  :  00  :  00  :  00  : 20  :  3f  :  2e"). 
Refer  to  f  aZoneCreate  for  more  details  on  the  use  of 
WWNs  in  Fabric  Assist  zones. 

•  Fabric  Assist  zone  alias  names. 

•  Exactly  one  Fabric  Assist  host  member  (for  example, 

"h{1,  2}"). 

Examples 

To  remove  "array2"  from  "Blue_f azone": 

switch : admin>  fazoneremove  "Blue_f azone" ,  "array2" 
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See  also 

f aZoneAdd 
f aZoneCreate 
f aZoneDelete 
f aZoneShow 
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faZoneShow 


Displays  Fabric  Assist  zone  information. 

Synopsis 

fazoneshow  ["pattern"  [,  transflag]] 

Availability 

all  users 

Description 

Use  this  command  to  display  Fabric  Assist  zone  information.  Specifying  tfiis  command  withi  no  parameters 
or  with  the  second  parameter  set  to  0  displays  all  Fabric  Assist  zone  configuration  information  for  both 
defined  and  effective  configurations.  Defined  configuration  information  is  shown  from  the  transaction 
buffer.  Refer  to  the  cf  gShow  command  for  a  description  of  this  display. 

If  a  parameter  is  specified,  it  is  used  as  a  pattern  to  match  Fabric  Assist  zone  names,  and  those  that  match 
in  the  defined  configuration  are  displayed. 

NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  optional  operands: 

pattern  Specify  a  value  to  search  for  the  name  of  a  Fabric  Assist  zone. 

This  can  be  any  POSIX-style  expression.  Patterns  can  contain: 

•  Question  mark  (?),  which  matches  any  single  character 

•  Asterisk  (*),  which  matches  any  string  of  characters 

•  Ranges,  which  match  any  character  within  the  range: 
for  example,  [0-9]  or  [a-f] 

transflag  Specify  0  to  display  the  information  from  the  current  transaction, 

or  specify  1  to  display  information  from  the  original  buffer.  This 
operand  must  be  preceded  by  a  pattern.  If  this  operand  is 
omitted,  the  value  defaults  to  0. 

Examples 

To  display  all  Fabric  Assist  zones  beginning  with  the  letters  A  through  C: 

switch : ad[nin>  fazoneshow  "[A-C]*" 
fazone:  Blue_fazone 

1,1;   arrayl ;   1,2;  arraY2 

See  also 

f aZoneAdd 
f aZoneCreate 
f aZoneDelete 
f aZ  oneRemove 
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fcpLogClear 

Clears  the  FCPD  debug  information  log  (debug  command). 

Synopsis 

f cpLogClear 

Availability 

admin 

Description 

Use  this  command  to  clear  the  debug  information  logged  by  FCPD. 

Operands 

none 

Examples 

To  clear  the  FCPD  debug  information  log: 

switch : admin>  fcplogclear 

See  also 

fcpLogDi sable 
f cpLogEnable 
f cpLogShow 
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fcpLogDisable 

Disables  the  FCPD  debug  information  log  (debug  command). 

Synopsis 

fcpLogDisable 

Availability 

admin 

Description 

Use  this  command  to  disable  the  debug  information  logged  by  FCPD. 

Operands 

none 

Examples 

To  disable  the  FCPD  debug  information  log: 

switch :  adinin>  fcpLogDisable 

See  also 

f cpLogClear 
f cpLogEnable 
f cpLogShow 
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fcpLogEnable 

Enables  the  FCPD  debug  information  log  (debug  command). 

Synopsis 

fcpLogEnable 

Availability 

admin 

Description 

Use  this  command  to  enable  the  debug  information  logged  for  FCPD.  Debug  information  logging  is 
enabled  by  default. 

Operands 

none 

Examples 

To  enable  the  FCPD  debug  information  log: 

switch : admin>  fcpLogEnable 

See  also 

f cpLogClear 
fcpLogDi sable 
f cpLogShow 
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fcpLogShow 


Displays  the  FCPD  debug  information  log  (debug  command). 

Synopsis 

f cpLogShow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  debug  information  logged  at  various  stages  of  FCP  device  probing. 

Operands 

none 


Examples 

To  display  the  FCPD  debug  information  log: 


switch 

:  adinin> 

f cpLogShow 

Time  Stamp 

Event 

Port 

f ile&lineno 

argO 

argl 

arg2 

arg3 

arg4 

22 

34 

:10 

824 

FlshOrProbe 

26 

1 

459 

81 

0 

0 

:  0 

:0 

22 

34 

:10 

824 

ProbeFlsh 

26 

1 

2755 

0 

0 

0 

:  0 

:0 

22 

34 

:10 

825 

SCNRcvd 

26 

1 

3436 

2 

0 

0 

:  0 

:0 

22 

34 

:14 

232 

FlshOrProbe 

26 

1 

459 

80 

0 

0 

:  0 

:0 

22 

34 

:14 

232 

PrbMsg 

26 

1 

494 

0 

0 

0 

:  0 

:0 

22 

34 

:14 

233 

StartProbe 

26 

1 

961 

1 

0 

0 

:  0 

:0 

22 

34 

:14 

233 

StartProbe 

26 

1 

999 

0 

0 

0 

:  8000 

:0 

22 

34 

:14 

233 

ProbeFlsh 

26 

1 

2755 

1 

0 

0 

:  0 

:0 

22 

34 

:14 

234 

SndPLOGI 

26 

1 

1431 

1002a690 

llace 

1 

:  0 

:20526 

22 

34 

:14 

236 

AsyResp 

26 

1 

1540 

1002a690 

1002a768 

80 

:  1 

:10526 

22 

34 

:14 

236 

ElsRsp 

26 

1 

1606 

llace 

2000000 

20 

:  0 

:980000 

22 

34 

:14 

238 

SndPRLI 

26 

1 

2026 

1002a690 

llace 

2 

:  527 

:  0 

22 

34 

:14 

239 

AsyResp 

26 

1 

1540 

1002a690 

1002a8e8 

80 

:2 

:10527 

22 

34 

:14 

239 

ElsRsp 

26 

1 

1606 

llace 

2100014 

0 

:21 

:980000 

22 

34 

:14 

240 

SndINQ 

26 

1 

2504 

1002a690 

2 

528 

:  0 

:0 

22 

34 

:14 

244 

AsyResp 

26 

1 

1540 

1002a690 

1002a5f 0 

80 

:  5 

:10528 

22 

34 

:14 

244 

INQRsp 

26 

1 

1852 

1 

llace 

880008 

: llace 

:0 

22 

34 

:14 

244 

AsyResp 

26 

1 

1540 

1002a690 

1002a768 

80 

:  5 

:10528 

22 

34 

:14 

244 

INQRsp 

26 

1 

1852 

7 

llace 

980000 

: llace 

:  0 

22 

34 

:14 

245 

SndLOGO 

26 

1 

1939 

llace 

1002a690 

0 

:  0 

:20529 

22 

34 

:14 

245 

SndLOGO 

26 

1 

1946 

74f 

0 

0 

:  0 

:0 

22 

34 

:14 

247 

AsyResp 

26 

1 

1540 

1002a690 

1002a768 

80 

:4 

:10529 

22 

34 

:14 

247 

ElsRsp 

26 

1 

1606 

llace 

2000000 

0 

:  0 

:980000 

22 

34 

:14 

247 

lUDel 

26 

1 

1731 

1002a690 

1002a690 

0 

:  0 

:1 
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See  also 

f cpLogClear 
fcpLogDi sable 
f cpLogEnable 
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fcpProbeShow 

Displays  the  Fibre  Channel  Protocol  (FCP)  probe  information. 

Synopsis 

f  cpprobeshow  [  slotnumber/]  portnuraber 

Availability 

all  users 


Description 

Use  this  command  to  display  the  FCP  probing  information  for  a  particular  device,  which  should  be  of  type 
F/FL_Port.  If  the  given  port  is  not  either,  then  the  follov/ing  is  displayed: 


port  X  is  not  an  FL_Port  or  an  F_Port 


Operands 

This  command  has  the  following  operands: 

slotnumber  Specify  the  slot  number  for  a  Core  Switch  2/ 64  or  SAN  Director 

2/128.  For  all  other  switches,  this  operand  is  not  required.  The 
slot  number  must  be  followed  by  a  slash  (  /  )  and  the  port 
number,  so  that  each  port  is  represented  by  both  slot  number  (1 
through  4  or  7  through  10)  and  port  number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of 
1 0  slots.  Slot  numbers  5  and  6  are  control  processor  cards;  slots 
1  through  4  and  7  through  1 0  are  port  cards.  On  each  port 
card,  there  are  16  ports,  counted  from  the  bottom,  numbered  0 
to  15. 

portnumber  Specify  a  port  number.  Valid  values  for  port  number  vary, 

depending  on  the  switch  type.  This  operand  is  required. 
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Examples 

To  display  the  FCP  probe  information: 


switch : admin>  f cpprobeshow  4/4 

port  52  is  L-Port  and 

it  is  online. 

nodes  probed: 

2 

successful  PLOGis: 

2 

successful  PRLls : 

2 

successful  iNQUlRies : 

2 

successful  LOGOS: 

2 

outstanding  lUs : 

0 

probing  state : 

3 

probing  TOV: 

0 

probing  count: 

0 

probing  next : 

0 

pmap : 

0x00000000,  0x00000000, 

0x00000000, 

0x00000010 

update  map : 

0x00000000,  0x00000000, 

0x00000000, 

0x00000010 

list  of  devices (may  include  old  devices  on  the 

loop) : 

0x2b4e2 :    IBM  DDYF- 

-T09170R  F60N 

0x2b4e4 :    IBM  DDYF- 

-T09170R  F60N 

See  also 

portLoginShow 
portLogShow 


208   Fabric  OS  commands 


fcpRlsShow 

Display  the  Fibre  Channel  Protocol  (FCP)  Read  Link  Status  (RLS)  information. 


Synopsis 

f  cprlsshow  [slotnumber/]portnumber 


Availability 

all  users 


Description 

Use  this  command  to  display  the  FCP  RLS  information  for  a  particular  device,  which  should  be  either  an  F_ 
or  FL  Port.  If  the  given  port  is  not  either  of  these  the  follov/ing  displays: 


port  X  is  not  an  FL_Port  or  an  F_Port 


Operands 

This  command  has  the  following  operands: 

slotnumber  Specify  the  slot  number  for  a  Core  Switch  2/ 64  or  SAN  Director 

2/1  28.  For  all  other  switches,  this  operand  is  not  required.  The 
slot  number  must  be  followed  by  a  slash  (  /  )  and  the  port 
number,  so  that  each  port  is  represented  by  both  slot  number  (1 
through  4  or  7  through  10)  and  port  number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of 
1 0  slots.  Slot  numbers  5  and  6  are  control  processor  cards;  slots 
1  through  4  and  7  through  1 0  are  port  cards.  On  each  port 
card,  there  are  16  ports,  counted  from  the  bottom,  numbered  0 
to  15. 

portnumber  Specify  a  port  number.  Valid  values  for  port  number  vary, 

depending  on  the  switch  type.  This  operand  is  required. 


Examples 

To  display  the  FCP  RLS  information: 


switch : admin>  fcprlsshow  2/5 


link  fail       loss  sync       loss  sig      prtc  err      bad  word      crc  err 
Oxda  0  5  0  0  52  5  0 

Oxdc  0  3  0  0  330  0 


See  also 

portLoginShow 


portLogShow 
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fdmiCacheShow 

Displays  abbreviated  remote  FDMI  device  information,  according  to  remote  domain  ID. 

Synopsis 

f dmicacheshow 

Availability 

all  users 

Description 

Use  this  command  to  display  FDMI  cache  information  for  remote  domains  only. 

The  state  of  each  remote  domain,  identified  by  its  domain  ID,  is  shov/n  to  be  unknov/n,  knov/n, 
unsupported,  or  error. 

The  revision  of  the  switch  also  displays,  followed  by  the  World  Wide  Name  of  the  switch. 

For  HBAs,  only  the  HBA  identifiers  and  registered  port  lists  are  displayed.  No  detailed  HBA  attributes  are 
displayed.  For  registered  ports,  only  port  identifier  and  corresponding  HBA  are  shown;  no  detailed  port 
attributes  are  displayed. 

Operands 

none 

Examples 

To  display  the  FDMI  cache: 


switch : admin>  f dmicacheshow 

Switch  entry  for  domain  3 

state:  known 

version:  v310 

wwn:  10:00:00:60:69:90:03 

c7 

HBAs  : 

10:00:00:00:c9:25:9b:96 

Ports :  1 

10:00:00:00:c9:25:9b:96 

Total  count  of  devices  on  the 

switch  is  1 

f dmiShow 
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fdmiShow 

Displays  detailed  FDMI  device  information. 

Synopsis 

f dmishow 

Availability 

all  users 

Description 

Use  this  command  to  display  FDMI  information  for  all  HBAs  and  ports. 

Detailed  FDMI  information  is  displayed  for  local  HBAs  and  ports.  This  information  includes  the  HBA  with 
its  corresponding  ports,  along  with  their  respective  attributes. 

Only  abbreviated  FDMI  information  is  shown  for  HBA  and  ports  on  remote  switches. 
Operands 

none 

Examples 

To  display  FDMI  information  on  a  local  switch: 

switch : admin>  f dmishow 
Local  HBA  database  contains : 
10:00:00:00:c9:25:9b:96 
Ports:  1 

10:00:00:00:c9:25:9b:96 
Port  attributes: 

FC4  Types:  0x0001000001000000000000000000000000000000000000000000000000000000 

Supported  Speed:  0x00000001 

Port  Speed:  0x00000001 

Frame  Size:  0x00000800 
HBA  attributes: 

Node  Name:   20 : 00 : 00 : 00 : c9 : 25 : 9b: 96 
Manufacturer:   Emulex  Network  Systems 
Serial  Number:  0000c9259b96 
Model:  LP9000 

Model  Description:   Emulex  LightPulse  LP9000  1  Gigabit  PCI  Fibre 
Hardware  Version:  00000001 

Driver  Version:   SLI-2  SW_DATE:May     3  2002,   v5-2.11a2  **CT_TEST  1** 

Firmware  Version:  03814101 

OS  Name  and  Version:  Window  2  000 

Max  CT  Payload  Length:  0x00061300 

(continued  on  next  page) 
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Local  Port  database  contains : 
10:00:00:00:c9:25:9b:96 

Remote  HBA  database  contains  no  entry. 

Remote  Port  database  contains  no  entry. 

See  also 

f dmiCacheShow 
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filterTest 

Tests  frame  filters. 

Synopsis 

filtertest  [-passcnt  passcnt]  [-txports  itemlist]  [-scamoff  offset]  [-dcamoff 
offset]  [-fdefoff  offset] 

Availability 

admin 

Description 

Use  this  command  to  verify  the  ASIC  frame  level  filtering  logic  including  every  type  of  filter  actions: 

FLTACT_LIST_A  Action  to  handle  the  subgroup  A-based  filtering. 

FLTACT  LIST  B  Action  to  handle  the  subgroup  B-based  filtering. 

FLTACT  FROZEN  Action  to  handle  the  frame  frozen  process. 

FLTACT_DISCARD  Action  to  discard  frame. 

FLTACT_FORWARD  Action  to  forv/ard  frame. 

This  command  can  be  run  on  every  port  and  send  the  frame  in  internal  loopback  mode.  The  filter  test 
requires  two  different  ports  in  the  same  quadrant  because  the  filter  logic  in  the  transmitter  port  cannot 
work  if  the  frame  is  sent  directory  from  the  embedded  port. 

In  this  test,  the  filter  definition  covers  the  different  filtering  conditions,  shown  in  Table  1  2. 
Table  12    List  of  filter  test  numbers,  definitions,  and  action  types 


Number 

Filter  definition 

Action  type 

0 

unconditional  match 

Forv/ard 

1 

unconditional  match 

List  A 

2 

unconditional  match 

List  B 

3 

unconditional  match 

Frozen 

4 

unconditional  match 

Discard 

5 

SCAM  no  match  and  AL_PA  match 

List  A 

6 

SCAM&DCAM  match  and  AL_PA  match 

List  A 

7 

Zone  A  match  and  AL_PA  match 

List  A 

8 

Zone  B  match  and  AL_PA  match 

List  B 

9 

Zone  A&B  match  and  AL_PA  match 

List  B 

10 

Zone  A|  B  match  and  AL_PA  match 

Frozen 

11 

Zone  A|  B  match  and  AL_PA  match 

Discard 
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Operands 


This  command  has  the  following  operands 

--slot  slotnumber 


-passcnt  passcnt 
-txports  itemlist 
-scamoff  offset 

-dcamoff  offset 

-fdefoff  offset 


Specify  the  slot  number  on  which  the  diagnostic  operates.  The 
port  specified  are  relative  to  this  slot  number.  The  default  is  0 
and  designed  to  operate  on  fixed-port-count  products. 

Specify  the  number  of  times  to  perform  this  test.  The  default  value 
is  1. 

Specify  the  user  port  number(s)  to  perform  this  test.  All  user  ports 
are  set  by  default. 

Specify  the  program  location  to  write  SCAM  test  data  in  SCAM 
memory.  The  default  value  is  0.  The  maximum  offset  number  is 
set  if  the  specified  number  is  larger  than  the  limit. 

Specify  the  program  location  to  write  DCAM  test  data  in  DCAM 
memory.  The  default  value  is  0.  The  maximum  offset  number  is 
set  if  the  specified  number  is  larger  than  the  limit. 

Specify  the  program  location  to  write  filter  test  definition  data  in 
filter  definition  memory.  The  default  value  is  0.  The  maximum 
offset  number  is  set  if  the  specified  number  is  larger  than  the 
limit. 


Examples 


To  run  a  frame  filter  test: 


switch : admin> 

f iltertest 

-txports  3/1-3/3 

Running  filter 

test   

Test  Complete: 

f iltertest 

Pass  1  of 

1 

Duration  0  hr. 

0  itiin  &  2 

sec  (0:0:2: 

:  679)  . 

passed. 

Diagnostics 

When  it  detects  failure(s),  the  subtest  might  report  one  or  more  of  the  following  error  messages: 


DIAG-ACTTEST 

DIAG-FLTINIT 

DIAG-FLTRCV 

DIAG-FLTXMIT 

DIAG-NUMTEST 


Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 


See  also 


ItemList 
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firmwareCommit 


Commits  switch  firmware. 

Synopsis 

f  i  r  mwa  r  e  c  oinin  i  t 

Availability 

admin 

Description 

Use  this  command  to  commit  a  firmware  download  to  a  CP.  This  command  copies  an  updated  firmware 
image  to  the  secondary  partition  and  commits  both  partitions  of  the  CP  to  an  updated  version  of  the 
firmware.  This  must  be  done  after  each  firmware  download  and  after  the  switch  has  been  rebooted  and  a 
sanity  check  is  performed  to  make  sure  the  new  image  is  fine. 

For  switches  that  have  flash  memory  set  into  two  equal  partitions,  the  primary  partition  is  the  where  the 
system  boots  from;  the  secondary  partition  is  where  a  copy  of  the  firmware  is  stored,  in  case  the  primary 
partition  is  damaged. 

To  maintain  the  integrity  of  the  firmware  image  in  the  flash  memory,  the  f  irmwareDownload  command 
updates  the  secondary  partition  only.  When  f  irmwareDownload  completes  successfully  and  the  CP  is 
rebooted,  the  system  switches  the  primary  partition  (with  the  old  firmware)  to  the  secondary,  and  the 
secondary  partition  (with  the  new  firmware)  to  the  primary. 

The  default  behavior  of  the  f  irmwareDownload  command  is  to  automatically  run  the 
firmwareCommit  command  after  the  reboot.  If  you  decide  to  disable  the  autocommit  option  when 
running  f  irmwareDownload,  after  the  CP  is  rebooted,  you  must  execute  one  of  two  commands: 

•  firmwareCommit  copies  the  primary  partition  (with  new  firmware)  to  the  secondary  and  commits  the 
new  firmware  to  both  partitions  of  the  CP. 

•  f  irmwareRestore  copies  the  secondary  partition  (with  the  old  firmware)  to  the  primary  and  backs 
out  of  the  new  firmware  download.  The  f  irmwareRestore  command  can  be  run  only  if  autocommit 
was  disabled  during  the  firmware  download.  Autocommit  can  be  disabled  only  when  you  run 

f  irmwareDownload  in  single  mode. 

Operands 

none 

Examples 

To  commit  a  new  version  of  the  firmware: 

switch : adinin>  f irmwarecommit 
Validating  primary  partition. . . 
Doing 

f irmwarecoinitiit  now. 
Please  wait  . . . 
Replicating  kernel  image 


FirmwareCommit  completes  successfully. 
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See  also 

f irmwareDownload 
f irmwareRestore 
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firmwareDownload 


Downloads  switch  firmware  from  a  remote  host  or  local  directory. 

Synopsis 

f irmwaredownload   [    [-sbni]   host, user, pfile,passwd] 

Availability 

admin 

Description 

Use  this  command  to  download  switch  firmware  from  an  FTP  server  or  from  a  local  NFS  directory  to  the 
switch's  nonvolatile  storage  area. 

The  new  firmware  is  in  the  form  of  RPM  packages  with  names  defined  in  pfile,  a  binary  file  that  contains 
specific  firmware  information  (time  stamp,  platform  code,  version,  and  so  forth)  and  the  names  of 
packages  of  the  firmware  to  be  downloaded.  These  packages  are  made  available  periodically  to  add 
features  or  to  remedy  defects.  Contact  customer  support  to  obtain  information  about  available  firmware 
versions. 

In  dual-domain  systems,  this  command  by  default  downloads  the  firmware  image  to  both  CPs  in  rollover 
mode,  to  prevent  disruption  to  application  services.  This  operation  depends  on  HA  support.  If  HA  is  not 
available,  a  user  can  still  upgrade  the  CPs  one  at  a  time,  using  the  -s  option. 

All  systems  supported  by  this  firmware  have  two  partitions  of  nonvolatile  storage  areas,  a  primary  and  a 
secondary,  to  store  two  firmware  images.  firmwareDownload  always  loads  the  new  image  into  the 
secondary  partition  and  swaps  the  secondary  partition  to  be  the  primary.  It  then  reboots  the  CP  and 
activates  the  new  image.  Finally,  it  performs  the  f  irmwareCommit  procedure  automatically,  to  copy  the 
new  image  to  the  other  partition,  unless  -n  is  used. 

The  command  supports  both  non interactive  and  interactive  modes.  If  it  is  invoked  without  any  command 
line  parameters,  or  if  there  is  any  syntax  error  in  the  parameters,  the  command  goes  into  interactive  mode, 
in  which  the  user  is  prompted  for  input. 

'2^^  NOTE:    Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  procedures  user  guide  for  information  about 
limitations  when  changing  Fabric  OS  versions.  When  installing  Fabric  OS,  the  procedure  might  vary, 
depending  on  which  version  of  the  Fabric  OS  you  are  migrating  from. 


Operands 

By  default,  firmwareDownload  performs  full  install,  autoreboot,  and  autocommit.  These  modes  are 
selectable  only  in  single-CP  mode,  in  which  case  autoreboot  is  off  by  default.  A  user  can  change  these 
settings  interactively  or  using  the  following  options: 

-s  Specify  this  operand  to  enable  single-CP  mode.  In  dual-CP  systems,  this 

mode  enables  a  user  to  upgrade  a  single  CP  and  to  select  full  install, 
autoreboot,  and  autocommit. 

-b  Specify  this  operand  to  activate  autoreboot  mode.  After  downloading 

firmware,  the  system  must  be  rebooted.  If  single-CP  mode  is  enabled  and 
this  operand  is  not  specified,  the  user  must  issue  the  reboot  command 
manually  to  activate  the  downloaded  image.  If  autoreboot  mode  is 
enabled,  the  switch  reboots  automatically  after  the  firmwareDownload 
command  has  been  run. 
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-n  Specify  this  operand  to  deactivate  autocommit  mode.  By  default,  after 

running  this  command  and  after  the  reboot,  the  switch  performs  a 
f  irmwareCommit  command  automatically.  When  this  mode  is  disabled, 
the  user  needs  to  issue  the  f  irmwareCoinmit  command  manually  to 
replicate  the  downloaded  image  to  both  partitions  of  a  CP. 

-i  Specify  to  activate  incremental  upgrade  mode.  By  default,  this  command 

installs  all  the  packages  in  the  pfile.  When  this  mode  is  enabled,  the  names 
of  the  packages  in  pfile  are  compared  to  those  installed  on  the  switch,  and 
only  the  packages  whose  names  are  different  are  installed. 

host  Specify  a  host  server  name  or  IP  address:  for  example,  citadel  or 

"1 92.1 68.1 66.30".  The  pfile  is  downloaded  from  this  host.  If  this  operand 
is  not  used,  the  pfile  is  considered  to  be  accessible  through  a  local 
directory. 

user  Specify  a  user  name  for  FTP  server  access:  for  example,  "jdoe".  This  user 

name  is  used  to  gain  access  to  the  host.  This  operand  can  be  omitted  if 
pfile  is  accessible  through  a  local  directory  or  if  the  FTP  user  ID  is 
anonymous. 

pfile  Specify  a  fully  qualified  path  and  file  name:  for  example, 

/v4  .4  .  0 /release. plist.  Absolute  path  names  might  be  specified 
using  forward  slash  (/). 

passwd  Specify  a  password.  This  operand  can  be  omitted  if  pfile  is  accessible 

through  a  local  directory  or  if  no  password  is  required  by  the  FTP  server. 

If  no  operand  is  specified,  the  operation  becomes  interactive  and  you  are  prompted  for  input. 

Examples 

To  download  the  firmware  to  an  HA  switch: 

switch : admin>  f irmwareDownload 

192. 168. 166 . 3  0, johndoe, /pub/dist /release . plist , 12  34  5 

This  command  will  upgrade  both  CPs  in  the  switch.   If  you 
want  to  upgrade  a  single  CP  only,  please  use  -s  option. 

You  can  run  f irmwareDownloadStatus  to  get  the  status  of 
this  command. 

This  command  will  cause  the  active  CP  to  reset  and  will 
require  that  existing  telnet,   secure  telnet  or  SSH  sessions 
be  restarted. 

Do  you  want  to  continue   [Y] : 

FirmwareDownload  has  started  in  Standby  CP.   It  may  take  up  to  10 
minutes . 


(continued  on  next  page) 
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And  you  will  the  following  on  Standby  CP: 


Start  to  install  packages  

dir  ################################################ 
terminfo  ################################################ 
termcap  ################################################ 
glibc  ################################################ 


sin  ################################################ 
Write  kernel  image  into  flash. 


Verification  SUCCEEDED 

Firmwaredownload  completes  successfully. 

Diagnostics 

The  following  can  cause  the  download  to  fail: 

Host  is  not  known  to  the  switch 

Host  cannot  be  reached  by  the  switch 

User  does  not  have  permission  on  host 

The  pfile  does  not  exist  on  host 

The  pfile  is  not  in  the  right  format 

Package  specified  in  the  pfile  does  not  exist 

The  FTP  server  is  not  running  on  host 

Running  f  irmwareDownload  during  POST 

A  loss  of  power  to  the  switch 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 


See  also 


f irmwareCommit 

f irmwareDownloadStatus 

f irmwareRestore 

f irmwareShow 

reboot 


version 
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f  irmwa  reDown  loadStatus 

Displays  the  status  of  a  firmware  download. 

Synopsis 

f irmwaredownloadstatus 

Availability 

admin 

Description 

Use  this  command  to  display  an  event  log  that  records  the  progress  and  status  of  the  current 

f  irmwareDownload  command.  The  event  log  is  created  by  the  current  f  irmwareDownload  command 
and  is  kept  until  another  f  irmwareDownload  command  is  issued.  There  is  a  timestamp  associated  with 
each  event. 

In  a  Core  Switch  2/64  or  SAN  Director  2/128,  when  f  irmwareDownloadStatus  is  run,  the  event 
logs  in  the  two  CPs  are  synchronized.  The  command  can  be  run  from  either  CP. 

Operands 

none 

Examples 

To  display  the  status  of  a  firmware  download: 


switch : admin>  f irmwaredownioadstatus 

[1]  : 

Tue  Jan 

18 

13  :21:25  2004 

cpl :  Firmwaredownload  has  started  on  Standby  CP.  It 
minutes  . 

may  take  up  to  10 

[1]  : 

Tue  Jan 

18 

13  :  21 : 35  2004 

cpl  : 

Firmwaredownload  has  completed  successfully  on  Standby  CP. 

[2]  : 

Tue  Jan 

18 

13:21:37  2004 

cpl  : 

Standby 

CP 

reboots . 

[3]  : 

Tue  Jan 

18 

13 : 24 :44  2004 

cpl  : 

Standby 

CP 

boots  up. 

[4]  : 

Tue  Jan 

18 

13 : 24 :45  2004 

cpl  : 

Standby 

CP 

booted  up  with  new  firmware. 

[5]  : 

Tue  Jan 

18 

13 : 24 : 51  2004 

cpO :  Active  CP 
Active . 

forced  failover  succeeded.  Now  this 

CP  is  becoming 

(coninued  on 

next  page) 
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[6]:   Tue  Jan  18  13:27:07  2004 

cpQ  :  Firmwaredownload  has  started  on  Standby  CP.  It  may  take  up  to  10 
minutes . 

[7]:   Tue  Jan  18  13:31:20  2004 

cpO :   Firmwaredownload  has  completed  successfully  on  Standby  CP. 

[8]:   Tue  Jan  18  13:31:23  2004 
cpO :  Standby  CP  starts  reboot. 

[9]:   Tue  Jan  18  13:33:54  2004 

cpO :   Standby  CP  booted  up  with  new  firmware. 

[10]:   Tue  Jan  18  13:33:56  2004 

cpO :   Firmwarecommit  has  st  airtGd.  on  both  Activs  and.  Sta-ndby  CPs . 
[11]:  Tue  Jan  18  13:38:29  2004 

cpO :   Firmwarecommit  has  completed  successfully  on  Active  CP. 
[12]:  Tue  Jan  18  13:38:30  2004 

cpO :   Firmwaredownload  has  completed  successfully. 

See  also 

firmwarecommit 
f irmwareDownload 
f irmwareRestore 
f  irmwareSliow 
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firmwareRestore 

Restores  the  former  active  firmware  image. 

Synopsis 

f irmwarerestore 

Availability 

admin 

Description 

Use  this  command  to  restore  the  former  active  firmv/are  image.  This  command  can  only  be  run  if 
autocommit  v/as  disabled  during  the  f  irmwareDownload. 

After  a  f  irmwareDownload  and  a  reboot  (v/ith  autocommit  disabled),  the  downloaded  firmware 
becomes  active.  If  you  then  do  not  want  to  commit  the  firmware  and  want  to  restore  the  former  firmware, 

run  firmwareRestore.  After  running  firmwareRestore,  you  can  run  f irmwareDownload  again. 

This  command  reboots  the  system  and  makes  the  former  firmware  active.  After  reboot,  both  primary  and 
secondary  partitions  restore  to  the  former  firmware. 

This  command  only  takes  action  if  the  system  is  booted  after  a  f  irmwareDownload;  otherwise,  it  returns 
with  an  error  code. 

Operands 

none 

Examples 

To  restore  the  former  active  firmware  image: 


switch : admin>  f irmwarerestore 

Restore  old  image  to  be  active  . . . 

Restore  both  primary  and  secondary  image  after 

reboot . 

The  system  is  going  down  for  reboot  NOW  ! ! 

Broadcast  message  from  root   (ttySO)   Fri  Oct  26 

23  :48:54  2001.  .  . 

Doing  f irmwarecommit  now. 

Please  wait  . . . 

See  also 

f irmwareCommit 
f irmwareDownload 
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firmwareShow 

Displays  the  Fabric  OS  versions  on  both  partitions  of  the  local  and  remote  CPs. 

Synopsis 

f irmwareshow 

Availability 

admin 

Description 

Use  this  command  to  display  the  Fabric  OS  versions  on  primary  and  secondary  partitions.  For  systems 
v/ith  multiple  control  processor  (CP)  cards,  this  command  displays  this  information  for  both  local  and 
remote  CPs. 

Operands 

none 

Examples 

To  display  the  firmware  version  of  a  single-CP  system: 


switch : admin>  firmware 

show 

Primary  partition: 

v4 . 3  .  0 

Secondary  Partition: 

v4 . 3  .  0 

To  display  the  firmv/are  version  of  a  dual-CP  system: 


switch : admin>  f irmwareshow 

Local  CP   (Slot  5,   CP  1) : 

Active 

Primary  partition: 

v4  .  3  .  0 

Secondary  Partition: 

v4  .  3  .  0 

Remote  CP   (Slot  6,   CP  0) : 

Standby 

Primary  partition: 

v4  .  3  .  0 

Secondary  Partition: 

v4  .  3  .  0 

Note:  If  Local  CP  and  Remote  CP  have  different  versions 

of  firmware,   please  retry 

f irmwaredownload  command. 

See  also 

f IrmwareDownload 

f irmwareDownloadStatus 
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fportTest 


Functional  test  of  F->N,  N->F  point-to-point  path. 

Synopsis 

fporttest   [-nframes  count] [-ports  itemlist]  [-seed  payload_pattern] [-width 
pattern_width]  [-size  pattern_size] 

Availability 

admin 

Description 

Use  this  command  to  verify  the  functional  operation  of  the  switch  by  sending  ELS  ECHO  frames  from  the 
switch  F_Port  transmitter  and  receiving  ELS  ECHO  ACC  from  the  N_Port  device  into  the  F_Port  receiver. 
This  exercises  all  the  switch  components,  from  the  main  board,  to  the  SEP,  to  the  fiber  cable,  to  the  SFPs  (of 
the  N  Port  devices  and  the  switch  F  Port),  and  back  to  the  main  board. 

The  cables  and  SFPs  connected  should  be  of  the  same  technology;  that  is,  a  short  wavelength  SEP  (switch) 
port  is  connected  to  another  short  wavelength  SEP  (device)  port  using  a  short  wavelength  cable,  a  long 
wavelength  port  is  connected  to  a  long  wavelength  port;  and  a  copper  port  is  connected  to  a  copper 
port. 

Only  one  frame  is  transmitted  and  received  at  any  one  time.  The  port  LEDs  rapidly  flicker  green  while  the 
test  is  running. 

The  test  method  is  as  follows: 

1.  Determine  which  ports  are  E_Ports. 

2.  Create  an  ELS_ECHO  frame  with  payload  size,  data  pattern  build  in  or  payload  size,  data  pattern. 

3.  Transmit  frame  E  through  the  E_Port,  with  D  ID,  to  the  N_Port  device. 

4.  Wait  for  the  N_Port  device  to  respond  ECHO  ACC. 

5.  Compare  ECHO  data  transmitted  to  ECHO  data  received. 

6.  Repeat  steps  3  through  5  for  all  ports  present  until  either  the  number  of  frames  requested  is  reached,  or 
all  ports  are  marked  bad. 

You  can  specify  a  payload  pattern  to  be  used  when  executing  this  test.  If  the  pattern  is  not  user  specified, 
then  at  every  30  pass,  a  different  data  type  from  a  palette  of  seven  is  used  to  generate  a  different  data 
pattern  to  create  the  frame.  The  data  pattern  is  generated  based  on  data  type.  Some  data  types  might 
generate  a  different  data  pattern  on  every  pass;  other  data  types  might  not  change  the  data  pattern  in 
every  pass.  These  seven  data  types  are  repeated  every  210  pass.  The  data  palette  is  as  follows: 


CSPAT ( 0 ) : 

Ox7e, 

0x7e, 

0x7  e. 

0x7e,  . 

BYTE_LFSR(1) : 

0x69, 

0x01, 

0x02  , 

0x05,  . 

CHALF_SQ(2) : 

Ox4a, 

Ox4a, 

0x4a, 

0x4a,  . 

QUAD_N0T(3) : 

0x00, 

Oxff , 

0x00, 

Oxff,  . 

CQTR_SQ ( 4 ) : 

0x78, 

0x78, 

0x7  8, 

0x78,  . 

CRPAT ( 5 ) : 

Oxbc, 

Oxbc, 

0x2  3  , 

0x47,  . 

RAND0M(6) : 

0x2  5, 

Ox7f , 

0x6e, 

0x9a,  . 
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Operands 

This  command  has  the  following  optional  operands: 

■nf  rames  count  Specify  the  number  of  times  (or  number  of  frames  per  port)  to 

execute  this  test.  If  count  \s  omitted,  the  default  of  10  is  used. 

-ports  itemlist  Specify  the  ports  to  test.  If  itemlist  is  omitted,  the  test  is  executed 

on  all  online  F_Ports  in  the  specified  slot. 

-seed  payload_pattern  Specify  the  pattern  of  the  test  packets  payload.  When 

payload_pattern  is  set  to  0,  all  seven  data  types  are  used. 

-width  pattern_width  Specify  the  width  of  the  pattern  that  the  user  specified.  When 

payload_pattern  is  set  to  0x00,  pattern_width  is 
ignored.  Valid  values  are: 

1  byte 

2  word 
4  quad 

-size  pattern_size  Specify  the  number  of  words  in  the  test  packet  payload.  If 

pattern  size  is  omitted,  the  default  value  is  51  2. 

Examples 

To  run  fportTest  on  a  switch: 

switch :adinin>  fporttest  -ports  1/0-1/15 

Running  fPortTest   

Test  Complete:    "fporttest"  Pass  10  of  10 
Duration  0  hr,    0  min  &  1  sec  (0:0:0:127). 
passed. 


Diagnostics 

The  following  are  possible  error  messages  if  failures  are  detected: 

DATA 
INIT 

PORT_DIED 
EPI1_STATUS_ERR 


ERR_ 

_STAT 

ERR_ 

_STATS 

ERR_ 

_STATS_2L0NG 

ERR_ 

_STATS_BADEOF 

ERR_ 

_STATS_BADOS 

ERR_ 

_STATS_C3DISC 

ERR_ 

_STATS_CRC 

ERR_ 

_STATS_ENCIN 

ERR_ 

_STATS_ENCOUT 

ERR_ 

_STATS_TRUNC 

ERR_ 

_STAT_2L0NG 

ERR_ 

_STAT_BADEOF 

ERR_ 

_STAT_BADOS 

ERR_ 

_STAT_C3DISC 

ERR_ 

_STAT_CRC 
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ERR_STAT_ENCIN 

ERR_STAT_ENCOUT 

ERR_STAT_TRUNC 

FDET_PERR 

FINISH_MSG_ERR 

FTPRT_STATUS_ERR 

LE  S  SN_STATUS_ERR 

MBUF_STATE_ERR 

MBUF_STATUS_ERR 

NO_SEGMENT 

PORT_ABSENT 

PORT_ENABLE 

P0RT_M2M 

PORT_STOPPED 

PORT_WRONG 

RXQ_FRAME_ERR 

RXQ_RAM_PERR 

STATS 

STATS_C3FRX 

STATS_FRX 

STATS_FTX 

TIMEOUT 

XMIT 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

crossPortTest 

itemList 

loopPortTest 

portTest 

spinFab 
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fru  Replace 

Interactive  interface  to  replace  a  field  replaceable  unit  (FRU). 

Synopsis 

frureplace  FRU 

Availability 

admin 

Description 

Use  tfiis  command  to  guide  the  user  in  replacing  a  FRU.  The  command  automatically  performs  the 
necessary  backup  and  restore  (steps  to  accommodate  the  replacement). 

Operands 

This  the  following  operand  is  required: 

FRU  Specify  the  type  of  hardware  component  being  replaced.  WWN  is 

the  only  supported  value;  it  specifies  the  replacement  of  the 
WWN  card. 


Examples 

To  replace  the  World  Wide  Name  card: 

switch :  adinin>  frureplace  wwn 

This  is  the  WWN  card  hot  swap  interface. 

Continuing  from  this  point  will  require 

the  whole  process  to  be  completed. 

If  this  process  is  not  complete  due  to  a 

power  cycle,   or  CP  failover,  please  follow 

the  recovery  procedure  in 

Core  Switch    WWN  Card  Removal  and 

Replacement  document. 

Do  you  wish  to  continue   [y/n] ?  y 

Backing  up  WWN  card  data,  please 
wait  about  2  5  seconds  for  further 
instruction . 

Please  install  the  new  FRU  now. 
(continued  on  next  page) 


Fabric  OS  5.0.0  command  reference  guide  227 


If  this  session  lost  for  any  reason, 
please  re-enter  the  frureplace  command  and 
follow  the  instructions  to  complete  the 
operation. 

Please  enter  the  word  'continue'  after  the 

new  WWN  card  has  been  installed:  continue 

Restoring  the  information  to  the 

replacement  FRU  now,   please  wait  about 

2  0  seconds  to  complete 

Verifying  the  replacement  FRU  now. . . 

WWN  card  hot  swap  is  now  complete. 

FRU  replacement  completed  successfully! 

See  also 

none 
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fspfShow 

Displays  Fabric  Shortest  Path  First  (FSPF)  protocol  information. 

Synopsis 

f spf show 

Availability 

all  users 

Description 

Use  this  command  to  display  the  FSPF  protocol  information  and  internal  data  structures  to  the  FSPF 
module. 

Table  1  3  describes  the  information  that  this  command  displays. 
Table  13    Information  displayed  by  f  spf  show  command 


Field 

Description 

version 

Version  of  FSPF  protocol. 

domainID 

Domain  number  of  local  switch. 

switchOnline 

btate  ot  the  local  switch. 

domainValid 

i-»             .          fill           1          '  1    1     '                     1 1               f'  1 

Domain  ot  the  local  switch  is  currently  contirmed. 

isLports 

Bit  map  of  all  E_Ports. 

trunk_ports 

Dit  map  ot  all  the  trunk  ports. 

f_ports 

Bit  map  of  all  the  Fx_Ports. 

seg_ports 

D  •!                     I       II  iL                             1     J  1 

Dit  map  ot  all  the  segmented  ports. 

active_ports 

Bit  map  of  all  the  ONLINE  ports. 

minLSArrival 

FSPF  constant. 

minLSInterval 

FSPF  constant. 

LSoriginCount 

Internal  variable. 

startTime 

Start  time  of  tFspf  task  (milliseconds  from  boot). 

fspfQ 

FSPF  input  message  queue. 

fabP 

Pointer  to  fabric  data  structure. 

agingTID 

Aging  timer  ID. 

agingTo 

Aging  time  out  value,  in  milliseconds. 

IsrDlyTID 

Link  State  Record  delay  timer  ID. 

IsrDelaylo 

Link  State  Record  delay  time  out  value,  in  milliseconds. 
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Table  13    Information  displayed  by  f  spf  show  command  (continued) 


Field 

Description 

IsrDelayCount 

Counter  of  delayed  Link  State  Records. 

ddb_sem 

FSPF  semaphore  ID. 

event_sch 

FSPF  scheduled  events  bit  map. 

Operands 

none 

Examples 

To  display  FSPF  protocol  information: 


switch: admin>  f spf show 

version 

2 

domainID 

131 

switchOnline 

TRUE 

doitiainValid 

TRUE 

isl_ports [ 0 ] 

0x00000000 

isl_ports [1] 

0x74000000 

trunk__ports  [  0  ] 

0x00000000 

trunk__ports  [  1  ] 

0x02000000 

f_ports [0] 

0x00400000 

f_ports [1] 

= 

0x00000000 

seg_ports [ 0 ] 

0x00000000 

seg_ports [ 1 ] 

0x00000000 

active_ports [0] 

0x00400000 

active_ports [1] 

0x76000000 

minLSAr rival 

3 

minLS Interval 

5 

LSoriginCount 

3 

startTime 

50222 

fspfQ 

0xl003e640 

fabP 

0xl003e630 

agingTID 

0xl004ca28 

agingTo 

10000 

IsrDlyTID 

0xl00507a8 

iBrDelayTo 

5000 

iBrDelayCount 

1 

ddb_sein 

0xl003e6e8 

fabP: 

event_sch 

0x0 

230   Fabric  OS  commands 


See  also 

bcastShow 

topologyShow 

urouteShow 
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fwAlarmsFilterSet 


Enables  or  disables  alarms  for  Fabric  Watch. 

Synopsis 

fwalarmsf ilterset  [mode] 

Availability 

admin 


1^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  configure  alarm  filtering  for  Fabric  Watch.  By  turning  off  the  alarms,  all 
non-environment  class  alarms  are  suppressed.  By  turning  on  the  alarms,  all  class  alarms  are  generated. 

Operands 

This  command  has  the  following  operand: 

mode  Specify  1  to  enable  the  alarms,  0  to  disable  the  alarms.  If  no 

operand  is  specified,  the  default  value  is  0  (alarms  deactivated).  This 
operand  is  optional. 

Examples 

To  enable  alarms  in  Fabric  Watch: 

switch : admin>  fwalarmsf ilterset 
Coimnitting  configuration ...  done . 
FW:  Alarms  are  disabled 

switch : admin>  fwalarmsf ilterset  1 
Committing  configuration ...  done . 
FW:  Alarms  are  enabled 


See  also 

fwAlarmsFilterShow 
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fwAlarmsFilterShow 


Displays  alarm  filtering  for  Fabric  Watch. 


Synopsis 


fwalarmsf iltershow 


Availability 


all  users 


\^^}f  NOTE:    This  command  requires  a  Fabric  Watch  license. 


Use  this  command  to  display  whether  alarm  filtering  is  enabled  or  disabled. 


To  display  the  status  of  alarm  filtering  in  Fabric  Watch: 

switch :user>  fwalarmsf iltershow 
FW:  Alarms  are  enabled 

switch:user>  fwalarmsf iltershow 
FW:  Alarms  are  disabled 


Description 


Operands 


none 


Examples 


See  also 


fwAlarmsFilterSet 
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fwClasslnit 

Initializes  all  classes  under  Fabric  Watch. 

Synopsis 

fwclassinit 

Availability 

admin 


\^^}f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  initialize  all  classes  under  Fabric  Watch.  The  command  should  only  be  used  after 
installing  a  Fabric  Watch  license  to  start  licensed  Fabric  Watch  classes.  Refer  to  fwConf  igure  for  a  list 
of  classes. 

Operands 

none 

Examples 

To  initialize  all  classes  under  Fabric  Watch: 

switch :  ac3inin>  fwclassinit 

fwClasslnit:   Fabric  Watch  is  updating... 

fwClasslnit:  Fabric  Watch  has  been  updated. 

See  also 

fwConf igReload 
fwConf igure 
fwShow 
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fwConfig  Reload 

Reloads  the  Fabric  Watch  configuration. 

Synopsis 

fwconf igreload 

Availability 

admin 

[^^}f  NOTE:    This  command  requires  a  Fabric  Watch  license. 


Use  this  command  to  reload  the  Fabric  Watch  configuration.  This  command  should  only  be  used  after 
downloading  a  new  Fabric  Watch  configuration  file  from  a  host. 


Operands 

none 

Examples 

To  reload  the  saved  Fabric  Watch  configuration: 


switch :  adinin>  fwconf  igreload 

fwConf igReload :   Fabric  Watch  configuration  reloaded 


Description 


See  also 


conf igDownload 


conf igUpload 


fwClassInit 


fwConf igure 


fwShow 
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fwConfigure 

Displays  and  modifies  the  Fabric  Watch  configuration. 

Synopsis 

fwconfigure    [--enable  --port  portNumber]    \    [--disable  --port  portNumber] 

Availability 

admin 

NOTE:   This  command  requires  a  Fabric  Watch  license. 
Description 

Use  this  command  to  display  and  modify  threshold  information  for  the  Fabric  Watch  configuration.  Switch 
elements  monitored  by  Fabric  Watch  are  divided  into  classes,  which  are  further  divided  into  areas.  Each 
area  can  include  multiple  thresholds. 

In  addition,  the  command  can  be  used  to  disable  or  enable  all  thresholds  associated  with  a  given  port. 

The  Fabric  Watch  classes  and  areas  are  provided  in  Table  1 4. 

Table  14    The  fwConfigure  command  Fabric  Watch  classes  and  areas 


Class 

Area 

Environmental 

Temperature 

Fan 

Power  Supply 

SFP 

Temperature 

RXP 

TXP 

Current 

Voltage 

Port 

Link  loss 

Sync  loss 

Signal  loss 

Protocol  error 

Invalid  words 

Invalid  CRCS 

RXPerformance 

TXPerformance 

State  Changes 

236   Fabric  OS  commands 


Table  14   The  fwConf  igure  command  Fabric  Watch  classes  and  areas  (continued) 


Class 

Fabric 

E_Port  downs 

Fabric  reconfigure 

Domain  ID  changes 

Segmentation  changes 

Zone  changes 

Fabric<->QL 

("1 /"  l/^/^inc 
1  UUI  l(-  Iv^y  1 1  \o 

SFP  Qtntp  ^"h^ln^^PQ 

E_Port 

Link  loss 

Sync  loss 

Signal  loss 

Protocol  error 

Invalid  words 

Invalid  CRCS 

RXPerformance 

TXPprformn  n(~p 

Stntp  (  hnnnpQ 

F/FL_Port  (Optical) 

Link  loss 

Sync  loss 

Signal  loss 

Protocol  error 

Invalid  words 

Invalid  CRCS 

RXPerformance 

TXPerformance 

State  Changes 

AL  PA  PGrformanc©  Monitor 

inVQIIQ  \„I\V^O 

EE  Performance  Monitor 

Invalid  CRCS 

RXPerformance 

TXPerformance 

Filter  Performance  Monitor 

Customer  Define 
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Table  14    The  fwConf  igure  command  Fabric  Watch  classes  and  areas  (continued) 


rincc 

Ar©Q 

Security 

Telnet  Violations 

HTTP  Violations 

API  Violations 

RSNMP  Violations 

V^SNMP  Violations 

SES  Violations 

MS  Violations 

Serial  Violations 

Front  Panel  Violations 

sec  Violations 

DCC  Violations 

Login  Violations 

Invalid  Timestamps 

Invalid  Signatures 

Invalid  Certificates 

SLAP  Failures 

SLAP  Bad  Packets 

TS  Out  of  Sync 

No-FCS 

Incompatible  Security  DB 

Illegal  Command 

Resource 

Flash 

Operands 

This  command  has  the  following  optional  operands: 

--enable  --port  portNumber  Enables  all  thresholds  associated  with  a  certain  port, 

--disable  --port  portNumber       Disables  all  thresholds  associated  with  a  certain  port. 
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Examples 

To  configure  thresholds: 


switch :  adinin>  fwconfigure 

1   :   Environment  class 

2    :   SFP  class 

3   :  Port  class 

4   :  Fabric  class 

5   :  E-Port  class 

6   :  F/FL  Port   (Optical)  class 

7    :  Alpa  performance  Monitor  class 

8   :   EE  performance  Monitor  class 

Q      •          ~\  "1  \~  i^t^    r~ii:i  "K"  "F  i~i  T^m  a  "ri  1^        IVTion  n  ■|~i~it^     o  "I  ^  a 
J      .      jr_LJ_L-t;-L     yfci-LJ-U-L  illcLIU^  t:    i'iQJli-LUU-L  C-J-CLoo 

10   :   Security  class 

11   :  Resource  class 

12    :  Quit 

Select  a  class  =>  :    (1..12)    [1]  1 

1   :  Temperature 

2    :  Fan 

3    :   Power  Supply 

4   :   return  to  previous  page 

Select  an  area  =>  :    (1..4)    [4]  1 

Index  ThrestioldName  Status 

CurVal 

LastEvent  LastEventTime 

LastVal 

LastState 

1        envTempOOl  enabled 

33  C 

started        10:28:59  on  02/01/2000 

0  C 

Informative 

2         envTemp002  enabled 

34  C 

started        10:28:59  on  02/01/2000 

0  C 

Informative 

3         envTemp003  enabled 

36  C 

oUcLXLcCi              ±\J  .  A  o  .  D  y     Oil  UZ/U±/ZUUU 

J-Ii  J_  UX  iLLd  1  L  V  t= 

4        envTemp004  enabled 

35  C 

started        10:28:59  on  02/01/2000 

0  C 

Informative 

5        envTemp005  enabled 

36  C 

started        10:28:59  on  02/01/2000 

0  C 

Informative 

1   :  refresh 

3   :  enable  a  threshold 

4   :   advanced  configuration 

5   :   return  to  previous  page 

Select  choice  =>  :    (1..5)  [5] 

switch : admin>  fwconfigure  --disable  --port  1 
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See  also 

fwClassInit 
fwConf igReload 
fwShow 
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fwFruCfg 


Displays  or  modifies  FRU  state  alert  configuration. 


Synopsis 

fwfrucfg  [--show] 

Availability 

admin 


\^^}f  NOTE:    This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  configure  FRU  states  and  actions.  Based  on  these  configuration  settings,  Fabric 
Watch  generates  action  when  an  FRU  state  changes.  To  configure  email  alerts,  use  fwMailCf  g. 


\^^)f  NOTE:   The  command  is  not  applicable  to  platforms  without  FRUs. 


If  no  operand  is  specified,  the  configuration  prompt  displays. 


Operands 


This  command  has  the  following  operand: 


--show 


Displays  the  current  FRU  configuration  setting. 


Fabric  OS  5.0.0  command  reference  guide  241 


Examples 

To  change  FRU  state  alert  configuration: 


switch : admin>  fwfrucfg 

The  current  FRU  configuration: 
Alarm  State 

Alarm  Action 

Slot 

0 

1 

Power  Supply 

0 

0 

Fan 

0 

0 

WWN 

0 

0 

Note  that  the  value  0 

for 

a  parameter  means  that 

it  is  NOT  used  in  the 

cal 

culation 

Configurable  Alarm  St 

ates 

are : 

Absent-1,  lnserted-2, 

On- 

4,  Off-8, 

Faulty-16 

Configurable  Alarm  Ac 

tions  are: 

Errlog-1,  E-mail-16 

Slot  Alarm  State:  (0. 

.31) 

[0]  3 

Slot  Alarm  Action:  (0 

.  .  17 

)  [1] 

Power  Supply  Alarm  St 

ate : 

(0. .31) 

[0] 

Power  Supply  Alarm  Ac 

tion 

:  (0..17) 

[0] 

Fan  Alarm  State:  (0.. 

31) 

[0] 

Fan  Alarm  Action:  (0. 

.17) 

[0] 

WWN  Alarm  State:  (0.. 

31) 

[0] 

WWN  Alarm  Action:  (0. 

.17) 

[0] 

Fru  configuration  sue 

cess 

fully  changed 

See  also 

fwConf igure 
fwMailCfg 
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fwHelp 

Displays  Fabric  Watch  command  information. 

Synopsis 

f whelp 

Availability 

all  users 

Description 

Use  this  command  to  display  the  commands  that  configure  Fabric  Watch. 

Operands 

none 

Examples 

To  display  a  summary  of  Fabric  Watch  commands: 

switch :user>  f whelp 


f anShow 

Show  fan  speeds 

fwAlarmsFi Iter Set 

Configure  alarms  filtering  for  Fabric  Watch 

fwAlarmsFi  Iter  Show 

Show  alarms  filtering  for  Fabric  Watch 

fwClassInit 

Initialize  all  Fabric  Watch  classes 

fwConf igure 

Configure  Fabric  Watch 

fwConf igReload  Reload 

Fabric  Watch  configuration 

fwFruCf g 

Configure  FRU  state  and  notification 

fwMailCfg 

Configure  Fabric  Watch  Email  Alert 

fwPortDe tail Show 

Create  a  report  with  detailed  port  information 

fwSamShow 

Show  availability  monitor  information 

fwSet 

Set  port  persistence  time 

fwSetToCustom 

Set  boundary  &  alarm  level  to  custom 

fwSetToDef ault 

Set  boundary  &  alarm  level  to  default 

fwShow 

Show  thresholds  monitored  or  port  persistence  time 

sensorShow 

Show  sensor  readings 

switchStatusPolicySet 

Set  switch  status  policy  parameters 

switchStatusPolicyShow 

Show  switch  status  policy  parameters 

switchStatusShow 

Show  overall  switch  status 

temp Show 

Show  switch  temp  readings 

See  also 

none 
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fwMailCfg 

Displays  and  configures  Fabric  Watch  email  alerts. 

Synopsis 


fwmailcf g 


Availability 

admin 


1^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  display  or  modify  the  configuration  and  status  of  the  Fabric  Watch  email  alert  in  the 
switch. 

Switch  elements  monitored  by  Fabric  Watch  are  divided  into  classes,  and  email  alerts  are  based  on  the 
classes.  Each  class  can  configure  one  email  address  as  the  alert  message's  receiver. 

For  an  email  alert  to  function  correctly,  add  the  CPO  and  CPl  IP  addresses  and  hostname  to  DNS  and 
also  set  the  domain  name  and  name  server.  The  ipAddrShow,  x,  and  dnsConf  ig  commands  can  be 
used  to  set  and  check  this  information. 

Operands 

none 


Examples 

To  configure  an  email  settings: 


switch :  ac3min>  fwmailcf  g 

1  :   Show  Mail  Configuration  Information 

2  :  Disable  Email  Alert 

3  :   Enable  Email  Alert 

4  :  Send  Test  Mail 

5  :  Set  Recipient  Mail  Address  for  Email  Alert 

6  :  Quit 

Select  an  item    =>   :    {1..6)    [6]  1 
(continued  on  next  page) 


244   Fabric  OS  commands 


Config  Show  Menu 


1 

:  Environment  class 

2 

:  SFP  class 

3 

:   Port  class 

4 

:  Fabric  class 

5 

:  E-Port  class 

6 

:  F/FL  Port   (Optical)  class 

7 
8 

:  Alpa  Performance  Monitor  class 

:  End-to-End  Performance  Monitor  class 

9 

:  Filter  Performance  Monitor  class 

10 

:   Security  class 

11 

:  Resource  class 

12 

:  FRU  Class 

13 

:  Quit 

Select  an  item  =>  :    (0..13)    [11]  1 


mail  configuration  information 


Email  Alert  =  disable 
Mail  Recipients  =  NONE 


1  :   Show  Mail  Configuration  Information 

2  :   Disable  Email  Alert 

3  :   Enable  Email  Alert 

4  :  Send  Test  Mail 

5  :   Set  Recipient  Mail  Address  for  Email  Alert 

6  :  Quit 

Select  an  item  =>   :    (1..6)    [6]  5 

(continued  on  next  page) 
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Mail  Config  Menu 

1  : 

Environment  class 

2  : 

SFP  class 

3  : 

Port  class 

4  : 

Fabric  class 

5  : 

E-Port  class 

6  : 

F/FL  Port    (Optical)  class 

7  : 

Alpa  Performance  Monitor  class 

8  : 

End-to-End  Performance  Monitor  class 

9  : 

Filter  Performance  Monitor  class 

10  : 

Security  class 

12  : 

FRU  Class 

13  : 

Quit 

Select 

an  item  =>   :    (0 . . 13 )    [11]  1 

Mail  To 

:    [NONE]  JoeDoe@bogus.com 

Email  Alert  configuration  succeeded! 

See  also 

fwConf igure 

ipAddrSet 

ipAddrSliow 
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f  wPortDeta  i  IShow 

Displays  the  port  information  for  specified  user  ports. 

Synopsis 

fwportdetailshow   [--p  portNumber]    \    [--s  portState] 

Availability 

all  users 


\^^}f  NOTE:    This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  print  the  overall  status  of  the  ports  specified.  The  overall  status  is  calculated  based  on 
the  follov/ing  contributors: 


Port  Errors 

LFA  Number  of  link  loss  occurrences  exceeded  limit  for  time  period 

LSY  Number  of  sync  loss  occurrences  exceeded  limit  for  time  period 

LSI  Number  of  signal  loss  occurrences  exceeded  limit  for  time  period 

PER  Number  of  protocol  errors  exceeded  limit  for  time  period 

INW  Number  of  invalid  words  exceeded  limit  for  time  period 

CRC  Number  of  invalid  CRC  errors  exceeded  limit  for  time  period 

PSC  Port  hardv/are  state  changed  too  often 

BLP  Buffer  limit  port 
SEP  Errors 

STM  SEP  temperature  is  out  of  specification 

SRX  SEP  receive  power  is  out  of  specification 

STX  SEP  transmit  power  is  out  of  specification 

SCU  SEP  current  is  out  of  specification 

SVO  SEP  voltage  is  out  of  specification 

The  overall  status  can  be  in  one  of  the  followings: 

Healthy  Every  contributor  is  healthy 

Marginal  One  or  more  contributors  are  in  this  status 

Faulty  Faulty  hardware 

Offline  Port  has  no  connectivity  or  is  disabled 


If  the  overall  status  is  not  healthy,  the  contributing  factors  also  are  listed. 

Operands 

If  no  operand  is  specified,  all  ports  are  displayed. 
This  command  has  the  following  operands: 
--p  portNumber  Yields  a  port  detail  report  for  a  specific  port. 
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--S  portState  Yields  a  port  detail  report  for  the  specified  portState.  Valid 

portState  entries  are: 

h  Report  based  on  all  healthy  ports 

m  Report  based  on  all  marginal  ports 

f  Report  based  on  all  faulty  ports 

o  Report  based  on  all  offline  ports 

Examples 

To  retrieve  a  port  detail  report: 


switch: 

user> 

fwportdetailshow  --s  h 

Port 

Detail  Report 

Report 

time:   06/07/2004  03: 

:11:44  PM 

Switch  Name:  switch 

IP  address 

:  10, 

.255.255.255 

Port 

Exception  report   [by  Healthy] 

-Port-Errors 

 SFP-Errors  

Port# 

■  Type 

State 

Dur (H:M)    LFA  LSY 

LSI   PER  INW 

CRC  PSC  BLP  STM  SRX 

STX  SCU 

SVO 

000 

E 

HEALTHY 

001; 

:  11 

001 

E 

HEALTHY 

001: 

:  11 

002 

F 

HEALTHY 

001: 

:  11 

003 

F 

HEALTHY 

001: 

:  11 

004 

E 

HEALTHY 

001: 

:  11 

005 

E 

HEALTHY 

001: 

:  11 

006 

E 

HEALTHY 

001: 

:  11 

007 

E 

HEALTHY 

001: 

:  11 

008 

E 

HEALTHY 

001: 

:  11 

009 

F 

HEALTHY 

001: 

:  11 

022 

F 

HEALTHY 

001: 

:  11 

023 

F 

HEALTHY 

001: 

:  11 

024 

E 

HEALTHY 

001: 

:  11 

025 

E 

HEALTHY 

001: 

:  11 

026 

F 

HEALTHY 

001: 

:  11 

027 

F 

HEALTHY 

001: 

:  11 

028 

E 

HEALTHY 

001: 

:  11 

029 

E 

HEALTHY 

001: 

:  11 

031 

F 

HEALTHY 

001: 

:  11 

(continued  on  next  page) 
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switch: 

user> 

fwportdetailshow  --s  h 

Port 

Detail  Report 

,  J.  ±  .  ^  ^  iriyi 

Switch  Name:  switch 

IP  address 

:  10 

.255  .255 .255 

Port 

Exception  report   [by  Healthy] 

-Port-Errors 

 SFP-Errors  

IT  O  JL  U  TT 

■  Type 

Dur(H:M)    LEA  LSY 

LSI  PER  INW 

CRC  PSC  BLP  STM  SRX 

STX  SCU 

svo 

000 

E 

HEALTHY 

001; 

:  11 

001 

E 

HEALTHY 

001 ; 

:  11 

002 

F 

HEALTHY 

001: 

:  11 

003 

F 

HEALTHY 

001; 

:  11 

004 

E 

HEALTHY 

001; 

:  11 

005 

E 

HEALTHY 

001; 

:  11 

006 

E 

HEALTHY 

001  ; 

:  11 

007 

E 

HEALTHY 

001; 

:  11 

008 

E 

HEALTHY 

001; 

:  11 

009 

F 

HEALTHY 

001  ; 

:  11 

022 

F 

HEALTHY 

001; 

:  11 

023 

F 

HEALTHY 

001; 

:  11 

024 

E 

HEALTHY 

001; 

:  11 

025 

E 

HEALTHY 

001; 

:  11 

026 

F 

HEALTHY 

001; 

:  11 

027 

F 

HEALTHY 

001; 

:  11 

028 

E 

HEALTHY 

001; 

:  11 

029 

E 

HEALTHY 

001  ; 

:  11 

031 

F 

HEALTHY 

001; 

:  11 

See  also 

switchStatusShow 
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fwSamShow 

Displays  switch  availability  monitor  information. 

Synopsis 

fwsamshow 

Availability 

all  users 


\^^}f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  display  information  about  port  availability.  The  information  displayed  includes  total 
uptime,  total  dov/ntime,  number  of  faulty  occurrences,  and  total  percent  of  dov/ntime  for  each  port. 

Operands 

none 

Examples 

To  display  port  summary  information  on  an  eight  port  switch: 


switch :user> 

fwsamshow 

Total 

Total 

Down 

Total 

Port# 

Type 

Up  Time 

Down  Time 

Occurrence 

Offline  Time 

(Percent) 

(Percent) 

(Times ) 

(Percent) 

0 

U_PORT 

0 

0 

0 

100 

1 

U_PORT 

0 

0 

0 

100 

2 

U_PORT 

0 

0 

0 

100 

3 

E_PORT 

21 

0 

0 

78 

4 

E_PORT 

20 

0 

0 

80 

5 

U_PORT 

0 

0 

0 

100 

6 

U_PORT 

0 

0 

0 

100 

7 

U_PORT 

0 

0 

0 

100 

See  also 

portShow 
switchShow 
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fwSet 

Sets  the  parameters  controlled  by  Fabric  Watch. 

Synopsis 

fwset   [--port  --persistence  seconds] 

Availability 

all  users 


\^^}f  NOTE:    This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  set  parameters  controlled  by  Fabric  Watch.  It  allows  the  user  to  set  the  port 
persistence  time  (time  in  which  a  port  must  persistently  be  in  a  marginal  state  before  being  labeled 
as  such) 

Operands 

The  operand  is  as  follows: 

--port  --persistence  seconds     Set  port  parameters.  Currently  only  port  persistence  time 

can  be  set  with  this  option.  Port  persistence  time  is  the  time 
period  in  which  a  port  must  be  persistently  in  a  state  before 
being  actually  being  recognized  as  such. 

Examples 

To  set  message  levels  and  port  persistence  time: 

switch;user>  fwset  --port  --persistence  18 

See  also 

fwShow 
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fwSetToCustom 


Sets  boundary  and  alarm  levels  to  custom  values. 

Synopsis 


fwsettocustom 


Availability 

admin 


1^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  set  boundary  and  alarm  levels  to  custom  values  for  all  classes  and  areas  in  Fabric 
Watch. 

Operands 

none 

Examples 

To  set  alarm  levels  to  custom  values: 

switch : admin>  fwsettocustom 
Committing  configuration ...  done . 

See  also 

fwSetToDefault 
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fwSetToDefault 


Returns  boundary  and  alarm  levels  to  the  default  values. 


Synopsis 

fwsettode fault 

Availability 

admin 


\^^}f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  return  boundary  and  alarm  levels  to  defaults  for  all  classes  and  areas  in  Fabric 
Watch. 

Operands 

none 


Examples 


To  return  alarm  levels  to  default  values: 


switch : adinin>  fwsettodef ault 


Committing  configuration ...  done . 


See  also 


fwSetToCustom 
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fwShow 

Displays  the  thresholds  monitored  by  Fabric  Watch. 

Synopsis 

fwshow   [--port  --persistence]    |    [--disable  --port] 

Availability 

all  users 


\^^}f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  display  the  thresholds  monitored  by  Fabric  Watch.  This  command  also  displays  the 
port  persistence  time  and  ports  with  all  thresholds  disabled. 

Operands 

The  operands  are  as  follows: 

--port  --persistence       Displays  the  time  that  a  port  must  be  persistently  in  a  state  before 

being  marked  as  such. 

--disable  --port  Displays  the  ports  that  have  all  associated  thresholds  disabled. 

Examples 

To  display  thresholds  and  port  persistence  time: 


switch 

user>  fwshow 

1  : 

Show  class  thresholds 

2  : 

Detail  threshold  information 

3  : 

Show  console  message  level 

4  : 

Show  port  persistence  time 

5  : 

Quit 

Select  an  item    =>   :    {1..3)    [3]  1 

1  : 

Environment  class 

2  : 

SFP  class 

3  : 

Port  class 

4  : 

Fabric  class 

5  : 

E-Port  class 

6  : 

F/FL  Port   (Optical)  class 

7  : 

Alpa  Performance  Monitor  class 

8  : 

End-to-End  Performance  Monitor  class 

9  : 

Filter  Performance  Monitor  class 

(continued  on  next  page) 
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10   :   Security  class 

11   :  Resource  class 

12    :  Quit 

Select  an  item    =>   :    (1..12)    [11]  1 

Nsrcis                             La.t)Gl  La.st 

value 

GnvF3.nO  0 1                           Env  F3.n  1 

2576  RPM 

till vr  diiu  U z                                    iLiiv    r  dii  z 

2518  RPM 

tril vr  cillU  U  J                                    iLilV    r  dli  j 

2481  RPM 

tJii  V  It  o  U  w  _L                                        iiiiiv    xri—ivvtiJ.     ou.^^-L_y  -L 

1 

(1  OK/0  FAULTY) 

tiliViroUUO                                            HjIIV     irUWtil.     OU-^^-Ly  O 

1 

(1  OK/0  FAULTY) 

envTempOOl                        Env  Temperature  1 

38  C 

envTemp004                        Env  Temperature  4 

40  C 

envTempO 0  6                        Env  Temperature  6 

25  C 

c:'TaT  n           r-i  '  i  i  c:*  i—i  ~y~  ^      "P  TsT  c  *^TjiT 

"1              •        O  r*i  /^TftT           1   ^  C  O           r*i  V"  Q      r*i       ~1  O 

Z         .     UtiUci-L-L     LliX     fciliU -LU.    ±11  J_  UX  lUd  L -L  UIl 

4     :   Show  port  persistence  time 

5      :  Quit 

Select  an  item    =>   :    (1..3)    [3]  2 

Enter  Threshold  Name   :    []  envFanOOl 

Jillv     i  triLLptiX  d  L  U.J- t=     -L  . 

Monitored  for:               1283    {21  mins) 

j-iasu  cnecKeQ.        ±u.3U.z±  on  uz/U-L/zuuu 

Lower  bound:                    0  C 

Upper  bound:                  7  5  C 

Buffer  Size:  10 

Value  history:                  33  C 

Disabled?  No 

Locked?  No 

(continued  on  next  page) 
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Ra.w  histoiTY:                    3  8  C 

JO  ^ 

JO  ^ 

TPl  ^rvc'  •      H-v                       /in     T'T?  T     n     "D  "CP  Fl 
r  ±CT.gb  .      UX                      4±  U  lK±'^kjJljKJiJJ 

CountsiT : 

Access  via:   Function  call 

Address :  0xl00155a8 

a T-m Tmcnn -1-  -  n-v-finnnnnni 

r\L  y  U-lUfcill  U  .      UXU  U  U  U  U  U  U  J- 

Previous:   0x00000026  (38) 

uu-irirenu .    uxuuuuuuzo  kjo) 

Events : 

Event  0  occurred  1  time ,    last  at 

15 

:30 

:  17 

on  12/09/2011 

Event  1  occurred  10  times,  last 

at 

16  : 

49  : 

02  on  12/09/2011 

*  Event  5  occurred  1  t ime ,    last  at 

.  J  u 

r\-n     1  9  /  riQ  /  9ni  1 
on    ±A  /  \jy  /  Z\j  ±1. 

Callbacks : 

iNU        CL X  J. J^cH„  Jv dl.  *d    I.  fcjy  ±  o  UcJL  fcrCl  . 

switch:user>  fwshow  --port  --persistence 

FW:   current  port  persistence  time  =  18s 

switch:user>  fwShow  --disable  --port 

Port          Threshold  Status 

1  disabled 

See  also 

fwClassInit 
fwConf igReload 
fwConf igure 
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Displays  shell  history. 

Synopsis 

h 

Availability 

all  users 

Description 

Use  this  command  to  view  the  shell  history.  The  shell  history  mechanism  is  similar  to  the  UNIX  Korn  shell 
history  facility.  It  has  a  built-in  line  editor  similar  to  UNIX  vi  that  enables  previously  typed  commands  to  be 
edited.  The  h  command  displays  the  20  most  recent  commands  typed  into  the  shell;  the  oldest  commands 
are  replaced  as  new  ones  are  entered. 

To  edit  a  command,  press  ESC  to  access  edit  mode  and  then  use  vi  commands.  The  ESC  key  switches  the 
shell  to  edit  mode.  The  ENTER  key  gives  the  line  to  the  shell  from  either  editing  or  input  mode. 

Basic  vi  commands  are  as  follows: 


k 

Move  the  cursor  up 

j 

Move  the  cursor  down 

h 

Move  the  cursor  left 

1 

Move  the  cursor  right 

a 

Append 

i 

Insert 

X 

Delete 

u 

Undo 

Operands 

none 

Examples 

To  display  previous  shell  commands: 

switch : adinin>  h 

1  version 

2  switchshow 

3  portdisable  2 

4  portenable  2 

5  switchshow 
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haDisable 

Disables  the  High  Availability  feature  in  the  switch. 

Synopsis 

hadisable 

Availability 

admin 

Description 

Use  this  command  to  disable  the  High  Availability  feature  in  the  sv/itch.  If  the  HA  feature  is  already 
disabled,  this  command  does  nothing. 

Operands 

none 

Examples 

To  disable  the  High  Availability  feature: 

switch : admin>  hadisable 
HA  is  disabled 

See  also 

haEnable 
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haDump 

Displays  information  about  the  status  of  the  High  Availability  feature  in  the  switch. 

Synopsis 

ha dump 

Availability 

all  users 

Description 

Use  this  command  to  display  information  about  the  status  of  the  High  Availability  feature  in  the  sv/itch.  This 
command  displays  the  follov/ing  information: 

•  Local  CP  state  (slot  number  and  CP  ID) 

•  Remote  CP  state  (slot  number  and  CP  ID) 

•  High  Availability  enabled/disabled 

•  Heartbeat  up/dov/n 

•  Health  of  standby  CP: 

Healthy  The  standby  CP  is  running  and  the  background  health  diagnostic 

has  not  detected  any  errors. 

Failed  The  standby  CP  is  running,  but  the  background  health  diagnostic 

has  discovered  a  problem.  Failover  is  disabled  until  the  standby 
CP  is  repaired.  The  information  of  the  failing  device  in  the 
standby  CP  is  displayed. 

Unknown  The  standby  CP  healthy  state  is  unknown  due  to  not  existing, 

heartbeat  is  down,  or  healthy  monitor  detects  a  configuration  file 
error. 

•  HA  synchronization  status: 

HA  State  Synchronized      The  system  is  currently  fully  synchronized.  If  a  failover  became 

necessary,  it  would  be  nondisruptive. 

HA  State  Not  In  Sync        The  system  is  unable  to  synchronize  the  two  CPs,  due  to  the 

standby  CP  being  faulty  or  another  system  error.  If  a  failover 
became  necessary,  at  this  time,  the  standby  CP  reboots,  and  the 
failover  is  disruptive. 

•  IP  and  Fibre  Channel  addresses  configured  for  the  switch. 

•  Additional  internal  HA  state  information,  subject  to  change. 

Operands 

none 
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Examples 

To  view  information  about  the  High  Availability  feature: 


switch : admin>  hadump 

hashow : 

Local  CP   (Slot  6,   CPl) :  Active 

Remote  CP   (Slot  5,  CPO): 

Standby,  Healthy 

HA  enabled,  Heartbeat  Up, 

HA 

State  synchronized 

ipaddrshow: 

SWITCHO 

Ethernet  IP  Address:  10.6 

4  . 11 

8.104 

Ethernet  Subnetmask :  255. 

o  c  c 

z  4  U  .  U 

Fibre  Channel  IP  Address : 

0.0 

.0.0 

Fibre  Channel  Subnetmask: 

0.0 

.0.0 

SWITCHl 

Ethernet  IP  Address:  10.6 

4  . 11 

8.105 

Ethernet  Subnetmask:  255. 

255  . 

240  .  0 

Fibre  Channel  IP  Address : 

0.0 

.0.0 

Fibre  Channel  Subnetmask: 

0.0 

.0.0 

(output  truncated) 

See  also 

haFailover 
haShow 
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haEnable 

Enables  the  High  Availability  feature  in  the  switch. 

Synopsis 

haenable 

Availability 

admin 

Description 

Use  this  command  to  enable  the  High  Availability  feature  in  the  sv/itch.  If  the  HA  feature  is  already 
enabled,  this  command  does  nothing. 

Operands 

none 

Examples 

To  enable  the  High  Availability  feature  in  the  switch: 

switch :  adinin>  haenable 
HA  is  enabled 

See  also 

haDisable 
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ha  Fa  i  lover 

Forces  the  failover  mechanism  so  that  the  standby  control  processor  (CP)  becomes  the  active  CP. 

Synopsis 

haf ailover 

Availability 

admin 

Description 

Use  this  command  to  force  the  failover  mechanism  to  occur  so  that  the  standby  CP  becomes  the  active  CP. 
Because  haFailover  results  in  CP  reboot,  a  v/arning  message  and  confirmation  are  displayed.  If  the 
user  confirms,  the  failover  takes  place. 

When  HA  synchronization  is  enabled  and  the  CPs  are  in  sync,  the  port  traffic  light  does  not  flash  during 
the  failover,  even  v/hile  traffic  is  continuing  to  flow. 

[i2^Jf  NOTE:    This  command  is  supported  only  on  systems  v/ith  dual  CP  cards. 


Operands 

none 

Examples 

To  force  the  failover  of  the  active  CP  to  the  standby  CP  in  the  switch: 

switch : admin>  haf ailover 

Local  CP   (Slot  6,   CPl) :  Active 

Remote  CP   (Slot  5,   CPO) :   Standby,  Healthy 

HA  enabled,  Heartbeat  Up,  HA  State  synchronized 


Warning:  This  command  is  being  run  on  a  control  processor (CP) 

based  system.  If  the  above  status  does  not  indicate  HA  State 

synchronized  then  this  operation  will  cause  the  active  CP  to  reset. 

This  will  cause  disruption  to  devices  attached  to  both  switch  0  and 
switch  1 

and  will  require  that  existing  telnet  sessions  be  restarted. 
To  just  reboot  a  logical  switch  on  this  system,   use  command 
switchreboot  on  the  logical  switch  you  intend  to  reboot. 

Are  you  sure  you  want  to  reboot  the  active  CP   [y/n] ?  Y 

See  also 

haDisable 

haEnable 

haShow 
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haShow 

Displays  control  processor  (CP)  status. 

Synopsis 

hashow 

Availability 

all  users 

Description 

Use  this  command  to  display  control  processor  status,  which  includes: 

•  Local  CP  state  (slot  number  and  CP  ID) 

•  Remote  CP  state  (slot  number  and  CP  ID) 

•  High  Availability  enabled/disabled 

•  Heartbeat  up/down 

•  Health  of  standby  CP: 

Healthy  The  standby  CP  is  running  and  the  background  health  diagnostic 

has  not  detected  any  errors. 

Failed  The  standby  CP  is  running,  but  the  background  health  diagnostic 

has  discovered  a  problem  v/ith  the  blade.  The  logs  should  be 
checked  to  determine  the  appropriate  repair  action.  Failover  is 
disabled  until  the  standby  CP  is  repaired. 

Unknown  The  standby  CP  healthy  state  is  unknown  due  to  not  existing, 

heartbeat  is  down,  or  healthy  monitor  detects  a  configuration  file 
error. 

•  HA  synchronization  status: 

HA  State  Synchronized      The  system  is  currently  fully  synchronized.  If  a  failover  became 

necessary,  it  would  be  nondisruptive. 

HA  State  Not  In  Sync        The  system  is  unable  to  synchronize  the  two  CPs,  due  to  the 

standby  CP  being  faulty  or  another  system  error.  If  a  failover 
became  necessary,  at  this  time,  the  standby  CP  reboots,  and  the 
failover  is  disruptive. 


NOTE:   This  command  might  not  be  supported  on  nonbladed  systems. 


Operands 

none 
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Examples 

To  display  CP  status: 

switch : admin>  hashow 

Local  CP   (Slot  6,   CPl) :  Active 

Remote  CP   (Slot  5,   CPO) :   Standby,  Healthy 

HA  Enabled,  Heartbeat  Up,  HA  State  Synchronized 

switch : admin>  hashow 

Local  CP   (Slot  6,   CPl) :  Active 

Remote  CP   (Slot  5,   CPO) :   Standby,  Failed 

Backplane  PCI  fail,   severity:  CRITICAL 
HA  enabled.  Heartbeat  Up,  HA  State  not  in  sync 

See  also 

haDisable 

haEnable 

haFailover 


264   Fabric  OS  commands 


haSyncStart 

Enables  HA  state  synchronization. 

Synopsis 

hasyncstart 

Availability 

admin 

Description 

Use  this  command  to  enable  the  HA  state  synchronization. 

Examples 

To  enable  the  HA  state  synchronization: 

switch ; adinin>  hasyncstart 

HA  State  synchronization  has  started 


See  also 

haFailover 

haShow 

haSyncStop 
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haSyncStop 

Disables  the  HA  state  synchronization. 

Synopsis 

hasyncstop 

Availability 

admin 

Description 

Use  this  command  to  temporarily  disable  the  HA  synchronization.  The  next  failover  that  takes  place  after 
might  be  disruptive. 

Operands 

none 

Examples 

To  disable  the  HA  state  synchronizing  process: 

switch : admin>  hasyncstop 

J 

See  also 

haFailover 

haShow 

haSyncStart 
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help 

Displays  help  information  for  commands. 

Synopsis 

help  [command] 

Availability 

all  users 

Description 

Use  this  command  without  a  operand  to  display  an  alphabetical  list  of  individual  commands.  At  the  end 
of  the  list  are  commands  that  display  groups  of  commands;  for  example,  diagShow  displays  a  list  of 
diagnostic  commands. 

The  list  displays  only  commands  that  are  available  to  the  current  user;  this  can  vary,  according  to: 

•  Login  user  level 

•  License  key 

•  Sv/itch  model 

To  access  help  information  for  a  specific  command,  enter  the  command  name  as  an  operand. 
Operands 

This  command  has  the  following  optional  operand: 
command  Specify  the  command  name,  with  or  without  quotation  marks. 

Examples 

To  display  help  information  for  the  passwd  command: 
switch  :adinin>  help  passwd 

See  also 

diagHelp 

fwHelp 

licenseHelp 

perf Help 

routeHelp 

tsHelp 

zoneHelp 
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historyLastShow 

Displays  the  late  entry  in  the  field  replaceable  unit  (FRU)  history  log. 

Synopsis 

hi story last show 

Availability 

all  users 


Description 

Use  this  command  to  display  the  contents  of  the  latest  history  log  record.  A  history  record  contains  three 
lines  of  information.  The  first  line  of  each  record  contains  the  following  data  sets: 


Object  type 


Object  number 
Event 

Time  of  the  event 

The  second  and  third 
lines  of  a  record  each 
contain  one  data  set, 
preceded  by  its  name: 

Factory  Part  Number 

Factory  Serial  Number 


CHASSIS,  FAN,  POWER  SUPPLY,  SW  BLADE  (port  blade),  CP 
BLADE  (control  processor),  WWN  (World  Wide  Name  card),  or 
UNKNOWN. 

Slot  number  for  blades  and  unit  number  for  everything  else. 
Inserted,  Removed,  or  Invalid, 
at  Day  Mon  dd  hh:mm:ss  yyyy 


xx-yyyyyyy-zz  or  Unknown 
xxxxxxxxxxxx  or  Unknown 


Operands 

none 

Examples 

To  display  the  late  FRU  insertion  or  removal  event: 

switch : admin>  historylastshow 


POWER  SUPPLY    Unit  2         Inserted  at  Tue  Aug  14  15:52:10  2  001 
Factory  Part  Number:  60-0001536-02 
Factory  Serial  Number:  1013456800 


Records:  11 


See  also 

historyShow 
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historyMode 


Displays  the  mode  of  the  history  log. 

Synopsis 

historymode  [mode] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  mode  of  the  history  buffer: 

Rotating  mode  New  messages  overwrite  the  oldest  messages  in  the  log. 

First-in  mode  Once  the  log  is  full,  all  additional  logs  are  discarded  so  that  the 

first  set  of  logs  to  fill  the  buffer  are  preserved. 

Operands 

none 

Examples 

To  change  the  history  mode  to  first-in  from  rotating: 

switch : adinin>  historymode 
History  Mode  is:  Rotating. 

See  also 

historyLastShow 
historyShow 
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historyShow 

Displays  the  entire  field  replaceable  unit  (FRU)  history  log. 

Synopsis 

historyshow 

Availability 

all  users 


Description 

Use  this  command  to  display  the  entire  history  log  buffer.  Each  history  record  contains  three  lines  of 
information.  The  first  line  of  each  record  contains  the  following: 


Object  type 


Object  number 
Event 

Time  of  the  event 

The  second  and  third 
lines  of  a  record  each 
contain  one  data  set, 
preceded  by  its  name: 

Factory  Part  Number 

Factory  Serial  Number 


CHASSIS,  FAN,  POWER  SUPPLY,  SW  BLADE  (port  blade),  CP 
BLADE  (control  processor),  WWN  (World  Wide  Name  card),  or 
UNKNOWN. 

Slot  number  for  blades  and  unit  number  for  everything  else. 
Inserted,  Removed,  or  Invalid, 
at  Day  Mon  dd  hh:mm:ss  yyyy 


xx-yyyyyyy-zz  or  Unknown 
xxxxxxxxxxxx  or  Unknown 


Operands 

none 
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Examples 

To  display  the  entire  contents  of  the  history  file: 


switch : adinin>  historyshow 

FAN     Unit  3 

Removed  at  Tue  Aug 

14 

10  : 

05: 

37 

1970 

Factory  Part  Nuiriber: 

Factory  Serial  Nuniber: 

lUl-5  4b  DO  UU 

POWER  SUPPLY     Unit  1 

Inserted  at  Tue  Aug 

14 

10 

:52 

:  10 

1970 

Factory  Part  Nuiriber: 

DU-UUUi33D-Uz 

Factory  Serial  Number: 

Not  Available 

FAN    Unit  3 

Inserted  at  Tue  Aug 

14 

10 

:23 

:45 

2001 

Factory  Part  Nuiriber: 

20-123456-12 

Factory  Serial  Number: 

1013456800 

TjiTTjiTT\T           T  Tirt  4-1—  1 

WWN    Unit  1 

Inserted  at  Tue  Aug 

14 

11 

:03 

:45 

2001 

Factory  Part  Nuiriber: 

40-0000031-03 

Factory  Serial  Number: 

1013456800 

{output  truncated) 

SW  BLADE     Slot  3 

Removed  at  Tue  Aug 

14 

12  : 

10  : 

09 

2001 

Factory  Part  Number: 

bU-UUUiboz-Uo 

Factory  Serial  Nuiriber: 

lU 43  bo  UU 

CP  BLADE     Slot  5 

Removed  at  Tue  Aug 

14 

13  : 

45: 

07 

2001 

Factory  Part  Number: 

dL)-UUIJ1dU4-Uz 

Factory  Serial  Number: 

FPUUXb  U  U 1^  o 

SW  BLADE     Slot  3 

Inserted  at  Tue  Aug 

14 

13 

:53 

:40 

2001 

Factory  Part  Number: 

D0-0U01b32-(J3 

Factory  Serial  Number: 

1U1345doUU 

CP  BLADE     Slot  6 

Inserted  at  Tue  Aug 

14 

13 

:59 

:50 

2001 

Factory  Part  Number: 

60-0001604-02 

Factory  Serial  Number: 

FP00X600128 

POWER  SUPPLY     Unit  2 

Inserted  at  Tue  Aug 

14 

15 

:52 

:  10 

2001 

Factory  Part  Number: 

60-0001536-02 

Factory  Serial  Number: 

1013456800 

Records:  11 
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See  also 

historyLastShow 
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httpCfgShow 

Displays  the  Java  plug-in  version. 

Synopsis 

httpcf gshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  version  of  the  Java  plug-in  supported  by  Web  Tools.  This  command  also 
displays  the  URL  from  v/hich  the  plug-in  can  be  dov/nloaded. 

Operands 

none 

Examples 

To  display  the  Java  plug-in  version: 

switch :  adinin>  httpcf  gshow 
Current  HTTP  configuration 
javaplugin. version  =  1,3,1 

javaplugin.homeURL  =  http://java.sun.com/products/plugin 

See  also 

none 
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Displays  a  task  summary. 


Synopsis 


i  [processID] 


Availability 

all  users 


Description 

Use  this  command  to  display  information  about  all  of  the  processes  or  about  a  specific  process  if  a 
process  ID  is  supplied.  One  line  is  displayed  per  process.  Fields  displayed  with  this  commands  include 
those  shown  in  Table  1  5. 

Table  15    i  Command  field  description 


Field 

Description 

c 
r 

Process  flags: 

ALIGNWARN 

001 

print  alignment  warning  messages 

STARTING 

002 

being  created 

EXITING 

004 

getting  shut  down 

PTRACED 

010 

set  if  ptrace  (0)  has  been  called 

TRACESYS 

020 

tracing  system  calls 

FORKNOEXEC 

040 

forked  but  did  not  exec 

SUPERPRIV 

100 

used  super-user  privileges 

DUMPCORE 

200 

dumped  core 

SIGNALED 

400 

killed  by  a  signal 

s 

Process  state  coc 

es: 

D  uninterruptibi 

e  sleep 

(usually  lO) 

R    runnable  (on 

run  queue) 

S  sleeping 

T  traced  or  stopped 

Z   a  defunct  ("zombie") 

process 

UID 

The  effective  user 

ID  num 

ber  of  the  process 

PID 

The  process  ID  of  the  process 

PPID 

The  process  ID  of  the  parent  process 

C 

Processor  utilization  for  scheduling 

PRI 

Priority  number  of  the  process;  higher  numbers  mean  lower  priority 

Nl 

Nice  value  used 

'n  priority  computation 
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Table  15    i  Command  field  description  (continued) 


Field 

Description 

ADDR 

Memory  address  of  the  process 

SZ 

■rl       1    1    1     ■          Til                        ■        ■  1  1 

me  total  size  ot  the  process  in  virtual  memory,  in  pages 

\  A         LI  A  hi  1 

WCHAN 

tL        JJ             I                   1  I          L-   L                    ■       1         •              LI  1 

The  address  ot  an  event  tor  v\/hich  process  is  sleeping  (it  blank,  process  is 
running) 

TTY 

The  controlling  terminal  of  the  process  (?  printed  for  no  controlling  terminal) 

TIME 

The  cumulative  execution  time  for  the  process 

CMD 

The  command  name  of  the  process 

Operands 

Tfiis  command  fias  the  following  operand: 

processiD  Specify  the  process  name  or  process  ID  for  the  process  to 

display. 

Examples 

To  display  information  about  process  ID  433: 


switch 

adinin> 

i  433 

F  S 

UID 

PID  PPID 

C  PRI 

NI  ADDR  SZ 

WCHAN 

TTY 

TIME 

CMD 

000  S 

0 

433  1 

0  69 

0         -  1283 

5c64  ? 

00 

00  :  02 

f abricd 

See  also 

diagHelp 
routeHelp 
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ifModeSet 


Sets  the  link  operating  mode  for  a  network  interface. 

Synopsis 

ifmodeset   ["interface"  ] 

Availability 

admin 

Description 

Use  this  command  to  set  the  link  operating  mode  for  a  network  interface. 

An  operating  mode  is  confirmed  with  a  y  or  yes  at  the  prompt.  If  the  operating  mode  selected  differs 
from  the  current  mode,  the  change  is  saved  and  the  command  exits. 

Changing  the  link  mode  is  not  supported  for  all  network  interfaces  or  for  all  Ethernet  network  interfaces. 
This  command  is  only  functional  for  the  ethO  interface. 

When  selecting  auto-negotiation,  you  can  choose  the  specific  link  operating  modes  that  are  advertised  to 
the  link  partner.  At  least  one  common  link  operating  mode  must  be  advertised  by  both  sides  of  the  link. 

When  forcing  the  link  operating  mode,  both  sides  of  the  link  must  be  forced  to  the  exact  same  mode.  The 
link  does  not  work  reliably  if  one  side  is  set  to  auto-negotiate  and  the  other  side  is  set  to  forced  mode. 

Exercise  care  when  using  this  command.  Forcing  the  link  to  an  operating  mode  not  supported  by  the 
network  equipment  to  which  it  is  attached  might  result  in  an  inability  to  communicate  with  the  system 
through  its  Ethernet  interface.  It  is  recommended  that  this  command  only  is  used  from  the  serial  console 
port.  When  used  through  an  interface  other  than  the  serial  console  port,  the  command  displays  a  warning 
message  and  prompts  the  user  to  for  verification  before  continuing,  this  warning  is  not  displayed  and  the 
user  is  not  prompted  when  the  command  is  used  through  the  serial  console  port. 

For  dual-CP  systems,  the  ifModeSet  command  affects  the  CP  that  you  are  currently  logged  in  to.  To  set 
the  link  operating  mode  on  the  active  CP,  you  must  issue  this  command  on  the  active  CP;  to  set  the  link 
operating  mode  on  the  standby  CP,  you  must  issue  this  command  on  the  standby  CP.  During  failover,  the 
link  operating  mode  is  retained  separately  for  each  CP,  because  the  physical  links  might  be  set  to  operate 
in  different  modes. 

Operands 

This  command  has  the  following  operand: 

interface  Specify  the  name  of  the  interface.  You  can  specify  the  name  with 

quotation  marks,  but  using  them  is  not  required.  For  example, 
you  can  use  either  ethO  or  "ethO",  where  eth  is  the  network 
interface  and  0  is  the  physical  unit. 
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Examples 

To  advertise  all  modes  of  operation,  when  not  entering  this  command  through  the  serial  console  port, 
follow  this  scenario  for  the  ifModeSet  command: 

switch : adinin>  ifmodeset  ethO 

Exercise  care  when  using  this  command.     Forcing  the  link  to 
an  operating  mode  not  supported  by  the  network  equipment  to 
which  it  is  attached  may  result  in  an  inability  to 
communicate  with  the  system  through  its  ethernet  interface. 

It  is  recommended  that  you  only  use  this  command  from  the 
serial  console  port. 

Are  you  sure  you  really  want  to  do  this?    (yes,   y,   no,   n) :    [no]  y 
Proceed  with  caution. 

Auto-negotiate   (yes,  y,  no,  n) :    [no]  y 

Advertise  100  Mbps  /  Full  Duplex   (yes,  y,   no,   n) :    [yes]  y 
Advertise  100  Mbps  /  Half  Duplex   (yes,  y,   no,   n) :    [yes]  y 
Advertise  10  Mbps  /  Full  Duplex   (yes,   y,   no,   n) :    [yes]  y 
Advertise  10  Mbps  /  Half  Duplex   (yes,   y,   no,   n) :    [yes]  y 
Committing  configuration ...  done . 

To  force  the  link  for  the  ethO  interface  from  auto-negotiation  to  1 0  Mbit/sec  half-duplex  operation,  when 
entering  this  command  through  the  serial  console  port: 


switch : admin>  ifModeSet  ethO 

Auto-negotiate   (yes,  y,  no,  n) :  [yes] 

n 

Force  100  Mbps  /  Full  Duplex   (yes,  y, 

no , 

.  n) 

:    [no]  n 

Force  100  Mbps  /  Half  Duplex   (yes,  y, 

no , 

.  n) 

:    [no]  n 

Force  10  Mbps  /  Full  Duplex   (yes,  y. 

no. 

n)  : 

[no]  n 

Force  10  Mbps  /  Half  Duplex   (yes,  y. 

no. 

n)  : 

[no]  y 

Committing  configuration ...  done . 

See  also 

IfModeSliow 
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ifModeShow 

Displays  the  link  operating  mode  for  a  network  interface. 

Synopsis 

ifmodeshow  [interface] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  link  operating  mode  for  a  network  interface. 

Operands 

This  command  has  the  following  operand: 

interface  Specify  the  name  of  the  interface.  You  might  specify  the  name 

with  quotation  marks,  but  using  them  is  not  required.  For 
example,  you  can  use  either  ethO  or  "ethO",  where  eth  is  the 
network  interface  and  0  is  the  physical  unit. 

Examples 

To  display  the  link  operating  mode  for  the  ethO  Ethernet  interface: 

switch : admin>  ifmodeshow  ethO 

Link  mode:  negotiated  lOObaseTx-HD,   link  ok 

See  also 

ifModeSet 
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interfaceShow 


Displays  FSPF  interface  information. 


Synopsis 


interf aceshow   [slotnumber/]  [portnumber] 


Availability 

all  users 


Description 

Use  this  command  to  display  the  two  data  structures  associated  with  FSPF  interfaces  (E_Ports)  on  the 
switch: 

•  The  permanently  allocated  Interface  Descriptor  Block  (IDB). 

•  The  neighbor  data  structure.  This  data  structure  is  allocated  when  a  switch  port  becomes  an  E  Port.  The 
neighbor  data  structure  contains  all  the  information  relating  to  the  switch  that  is  connected  to  an 
adjacent  switch. 

This  command  displays  the  content  of  both  data  structures,  if  they  have  been  allocated. 
The  following  fields  are  displayed: 


idbP 

nghbP 

ifNo 

masterPort 

defaultCost 

cost 

delay 

lastScn 

lastScnTime 

upCount 
lastUpTime 
downCount 
lastDownTime 
down  Reason 

iState 
state 


Pointer  to  IDB. 

Pointer  to  neighbor  data  structure. 
Interface  number. 

Port  number  of  the  trunk  master  port,  if  present,  of  the  trunk 
group  of  which  this  port  is  a  part. 

Default  cost  of  sending  a  frame  over  the  ISL  connection  to  this 
interface. 

Cost  of  sending  a  frame  over  the  ISL  connected  to  this  interface. 
A  value  of  1 000  indicates  a  1  -Gb/ sec  link.  A  value  of  500 
indicates  a  2-Gb/sec  link. 

Conventional  delay  incurred  by  a  frame  transmitted  on  this  ISL. 
A  fixed  value  required  by  the  FSPF  protocol. 

Type  of  the  last  State  Change  Notification  received  on  this 
interface. 

Time  the  last  State  Change  Notification  was  received  on  this 
interface. 

Number  of  times  this  interface  came  up,  with  respect  to  FSPF. 
Last  time  this  interface  came  up. 
Number  of  times  this  interface  went  down. 
Last  time  this  interface  went  down. 

Type  of  last  State  Change  Notification  that  caused  this  interface 
to  go  down. 

Current  state  of  this  interface.  The  state  can  be  UP  or  DOWN. 
An  interface  in  DOWN  state  does  not  have  an  allocated 
neighbor  data  structure  and  cannot  be  used  to  route  traffic  to 
other  switches. 

Current  state  of  this  interface.  This  E  Port  is  used  to  route  traffic 
to  other  switches  only  if  the  state  is  NB_ST_FULL. 
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nghbCap 

nghbid 

idbNo 

rem  Port 

nflags 

initCount 

lastlnit 

firstHio 
nbstFull 

&dbRetransList 
&lsrRetransList 
&lsrAckList 

inactTID 

helloTID 

dbRtxTID 

IsrRtxTID 

inactTo 


helloTo 
rXmitTo 

nCmdAcc 
nInvCmd 

nHloln 
nInvHio 

nLsuIn 
nLsaIn 
attHloOut 

nHloOut 
attLsuOut 

nLsuOut 
attLsaOut 

nLsaOut 


Neighbor  capabilities.  Should  be  0. 

Domain  ID  of  the  neighbor  (adjacent)  switch. 

IDB  number.  Should  be  equal  to  port_number. 

Port  number  on  the  remote  switch  connected  to  this  port. 

Internal  FSPF  flags. 

Number  of  times  this  neighbor  was  initialized  without  the 
interface  going  down. 

Time  the  last  initializing  state,  NB_ST_INIT,  on  this  interface. 

Time  the  first  hello  sent  on  this  interface. 

Time  the  last  finishing  state,  NB_ST_FULL,  on  this  interface. 

Pointer  to  the  database  retransmission  list. 

Pointer  to  the  Link  State  Records  (LSR)  retransmission  list. 

Pointer  to  the  Link  State  Acknowledgements  (LSA)  retransmission 
list. 

Inactivity  timer  ID. 
Hello  timer  ID. 

Database  retransmission  timer  ID. 
LSR  retransmission  timer  ID. 

Inactivity  timeout  value,  in  milliseconds.  When  this  timeout 
expires,  the  adjacency  with  the  neighbor  switch  is  broken  and 
new  paths  are  computed  to  all  possible  destination  switches  in 
the  fabric. 

Hello  timeout  value,  in  milliseconds.  When  this  timeout  expires, 
a  Hello  frame  is  sent  to  the  neighbor  switch  through  this  port. 

Retransmission  timeout  value,  in  milliseconds.  It  is  used  to 
transmit  topology  information  to  the  neighbor  switch.  If  no 
acknowledgement  is  received  within  this  value,  the  frame  is 
retransmitted. 

Total  number  of  commands  accepted  from  the  neighbor  switch. 
Number  includes  Helios,  Link  State  Updates  (LSU),  and  LSAs. 

Number  of  invalid  commands  received  from  the  neighbor  switch. 
Usually  commands  with  an  FSPF  version  number  higher  than  the 

one  running  on  the  local  switch. 

Number  of  Hello  frames  received  from  the  neighbor  switch. 

Number  of  invalid  Hello  frames  (Hello  frames  with  invalid 
parameters)  received  from  the  neighbor  switch. 

Number  of  LSUs  received  from  the  neighbor  switch. 

Number  of  LSAs  received  from  the  neighbor  switch. 

Number  of  attempted  transmissions  of  Hello  frames  to  the 
neighbor  switch. 

Number  of  Hello  frames  transmitted  to  the  neighbor  switch. 

Number  of  attempted  transmissions  of  LSUs  to  the  neighbor 

switch. 

Number  of  LSUs  transmitted  to  the  neighbor  switch. 

Number  of  attempted  transmissions  of  LSAs  to  the  neighbor 
switch. 

Number  of  LSAs  transmitted  to  the  neighbor  switch. 
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Operands 

This  command  has  the  following  operands: 

slotnumber  Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director 

2/128.  For  all  other  switches,  this  operand  is  not  required.  The 
slot  number  must  be  followed  by  a  slash  (  /  )  and  the  port 
number,  so  that  each  port  is  represented  by  both  slot  number  (1 
through  4  or  7  through  10)  and  port  number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of 
1 0  slots.  Slot  numbers  5  and  6  are  control  processor  cards;  slots 
1  through  4  and  7  through  1 0  are  port  cards.  On  each  port 
card,  there  are  16  ports,  counted  from  the  bottom,  numbered  0 
to  15. 

portnumber  Specify  a  port  number.  Valid  values  for  port  number  vary, 

depending  on  the  switch  type.  This  operand  is  optional. 

When  no  slot  number  and  port  number  are  specified,  this  command  displays  the  interface  information 
all  ports  on  the  switch  (including  non-E  Ports). 

Examples 

To  display  FSPF  interface  information: 

switch:user>  interf aceshow  1/4 
idbP  =  0xl008b3d0 

Interface  4  data  structure: 


nghbP 

0x1008 

c66? 

3 

if  No 

4 

masterPort 

4  (sel 

f ) 

def aultCost 

500 

cost 

500 

delay 

1 

lastScn 

16 

lastScnTime 

Apr 

02 

20: 

:01: 

:44, 

.458 

upCount 

2 

lastUpTime 

Apr 

02 

20: 

;01; 

:44, 

.458 

downCount 

1 

lastDownTime 

Apr 

02 

20: 

:01; 

:09, 

.  050 

downReason 

2 

iState 

UP 

Neighbor  4  data  structure: 
(continued  on  next  page) 
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attLsaOut 

2 
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2 

See  also 

nbrStateShow 

portShow 

switchShow 
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interopMode 


Enables  or  disables  HP  switch  interoperability  with  switches  from  other  manufacturers. 


Synopsis 

interopmode  [mode] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  interoperability  mode  for  individual  HP  switches.  This  feature 
enables  other  manufacturers'  switches  to  be  used  in  an  HP  fabric. 

This  command  must  be  executed  on  all  HP  switches  in  the  fabric.  The  switch  must  be  rebooted  after 
changing  interoperability  mode.  In  a  heterogeneous  fabric,  several  HP  features  are  not  available  in  order 
to  provide  maximum  compatibility  between  switches. 

HP  domain  IDs  must  be  between  97  and  1 27  for  successful  connection  to  other  switches.  The  firmware 
automatically  assigns  a  valid  domain  ID,  if  necessary,  when  interoperability  mode  is  enabled. 

Before  enabling  interoperability  mode,  the  individual  fabrics  should  be  inspected  for  compatibility.  Zones 
should  be  inspected  to  ensure  that  they  meet  the  zone  criteria  and  restrictions.  Remove  or  disable  any 
unsupported  optional  features.  Disable  the  Platform  Management  functions  using  the 

msPlMgmtDeactivate  command. 

When  the  switch  is  running  in  interoperability  mode,  the  following  normally  configurable  selections  are  set 
to  values  required  and  are  no  longer  changeable  using  the  configure  command:  Port  no.  zoning. 
Node  WWN  zoning,  QuickLoop  zoning,  virtual  channel  encoded  address,  and  Secure  Fabric  OS. 

When  interoperability  mode  is  disabled,  configuration  parameters  are  returned  to  their  default  states  and 
can  be  changed  using  the  configure  command. 


\^^}f  NOTE:    When  you  are  in  interoperability  mode,  the  only  type  of  zoning  supported  is  port  WWN  zoning. 


When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  PCS  switch. 


Operands 


This  command  has  the  following  operand: 


mode 


Specify  1  to  enable  interoperability  mode;  specify  0  to  disable 
interoperability  mode.  This  operand  is  optional. 


If  no  operand  is  specified,  the  current  value  is  displayed. 
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Examples 

To  view  and  then  enable  interoperability  mode: 


switch : admin>  interopmode 
InteropMode:  Off 

Usage:  InteropMode  0|l 

0:   to  turn  it  off 
1 :   to  turn  it  on 

switch : admin>  interopmode  1 

done . 

Interopmode  is  enabled, 
switch: admin>  reboot 

See  also 

configure 
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iodReset 

Turns  off  the  in-order  delivery  (lOD)  option. 

Synopsis 

iodreset 

Availability 

admin 

Description 

Use  this  command  to  turn  off  the  lOD  option.  The  lOD  option  is  turned  off  by  default;  however,  if  the  lOD 
option  v/as  turned  on  using  iodSet,  this  command  can  be  used  to  turn  it  off  again.  Disabling  lOD  allows 
fast  re-routing  after  a  fabric  topology  change. 

This  command  might  cause  out-of-order  delivery  of  frames  during  fabric  topology  changes. 
Operands 

none 

Examples 

To  turn  off  the  lOD  option: 

switch : admin>  iodreset 
switch :  adinin>  iodshow 


lOD  is  not  set 


See  also 

iodSet 
iodshow 
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iodSet 

Enables  the  in-order  delivery  (lOD)  option. 

Synopsis 

iodset 

Availability 

admin 

Description 

Use  this  command  to  enforce  in-order  delivery  of  frames  during  a  fabric  topology  change. 

In  a  stable  fabric,  frames  are  alv/ays  delivered  in  order,  even  v/hen  the  traffic  betv/een  sv/itches  is  shared 
among  multiple  paths.  Hov/ever,  when  topology  changes  occur  in  the  fabric  (for  instance,  a  link  goes 
down),  traffic  is  rerouted  around  the  failure  and  some  frames  might  be  delivered  out  of  order.  This 
command  ensures  that  frames  are  not  delivered  out-of-order,  even  during  fabric  topology  changes. 

The  default  behavior  is  for  the  lOD  option  to  be  off. 

This  command  should  be  used  with  care,  because  it  can  cause  a  delay  in  the  establishment  of  a  new  path 
when  a  topology  change  occurs.  Only  if  there  are  devices  connected  to  the  fabric  that  do  not  tolerate 
occasional  out-of-order  delivery  of  frames,  should  this  command  be  used. 

Operands 

none 

Examples 

To  turn  on  the  lOD  option: 


switch 

admin> 

iodset 

switch 

admin> 

iodshow 

lOD  is 

set 

See  also 


iodReset 
iodshow 
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iodShow 

Displays  the  in-order  delivery  (lOD)  option  setting. 

Synopsis 

iodshow 

Availability 

all  users 

Description 

Use  this  command  to  display  whether  the  lOD  option  is  enabled  or  disabled. 

Operands 

none 

Examples 

To  display  the  current  setting  of  the  lOD  option: 

switch  :adinin>  iodshow 

lOD  is  not  set 

See  also 

lodReset 
iodSet 
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ipAddrSet 

Sets  the  IP  address  details  for  a  switch  or  control  processor  (CP). 

Synopsis 

ipaddrset   [-cp  number]    [-sw  number] 

Availability 

admin 


Description 

Use  this  command  to  set  the  IP  addresses  on  the  switch  or  CP.  If  no  option  is  provided  on  a  chassis-based 
system,  the  command  displays  the  usage.  To  set  the  CP  IP  address  use  -cp;  to  set  the  switch  IP  address  use 
-sw.  When  setting  the  switch,  the  command  prompts  for  the  Ethernet  IP  address,  Ethernet  subnetmask. 
Fibre  Channel  IP  address,  and  Fibre  Channel  subnetmask.  When  setting  the  CP,  the  command  prompts  for 
the  Ethernet  IP  address,  Ethernet  subnetmask,  host  name,  and  gateway  IP  address. 

Valid  switch  and  CP  values  depend  on  the  platform  from  which  the  command  is  being  run.  For  a 
nonchassis-based  switch,  the  command  ignores  all  operands.  The  command  prompts  for  the  Ethernet  IP 
address,  Ethernet  subnetmask.  Fibre  Channel  IP  address.  Fibre  Channel  subnetmask,  and  gateway  IP 
address. 

Operands 

This  command  has  the  following  operands  on  a  chassis-based  system: 
-cp  number  Valid  options  include: 

•  0  sets  the  Ethernet  IP  address,  Ethernet  subnetmask,  gateway 
IP  address,  and  host  name  of  CPO. 

•  1  sets  the  Ethernet  IP  address,  Ethernet  subnetmask,  gateway 
IP  address,  and  host  name  of  CPl . 

-sw  number  Valid  options  include: 

•  0  sets  the  Ethernet  IP  address,  Ethernet  subnetmask.  Fibre 
Channel  IP  address,  and  Fibre  Channel  subnetmask  of 
logical  switch  0. 

•  1  sets  the  Ethernet  IP  address,  Ethernet  subnetmask.  Fibre 
Channel  IP  address,  and  Fibre  Channel  Subnetmask  of 
logical  switch  1 . 

If  no  option  is  specified  the  command  displays  the  usage. 

Examples 

To  set  the  IP  address  details  for  logical  switch  1  on  a  chassis-based  system: 


switch : admin>  ipaddrset  - 

sw  1 

Ethernet  IP  Address  [192. 

168.166 

148]  : 

Ethernet  Subnetmask  [255. 

255 .255 

0]  : 

Fibre  Channel  IP  Address 

[none] : 

Fibre  Channel  Subnetmask 

[none] : 

Committing  configuration. 

. . Done . 

OK. 
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See  also 

ipAddrShow 
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ipAddrShow 

Display  the  IP  address  information  for  a  switch  or  control  processor  (CP). 

Synopsis 

ipaddrshow   [-cp  cp_nuinber]    \    [-sw  sw_number] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  IP  addresses  configured  in  the  system. 

The  -cp  option  displays  the  CP  IP  address  and  the  -sw  option  displays  the  switch  IP  addresses.  For 
switches,  the  command  displays  the  Ethernet  IP  address,  Ethernet  subnetmask.  Fibre  Channel  IP  address, 
and  Fibre  Channel  subnetmask.  For  CPs,  the  command  displays  the  Ethernet  IP  address,  Ethernet 
subnetmask,  host  name,  and  gateway  IP  address. 

Operands 

This  command  has  the  following  operands: 

-cp  cp_nuinber  For  dual-CP  systems,  specify  CP  card  number  to  display  (0  or  1). 

-sw  sw_nuinber  For  dual-domain  systems,  specify  the  switch  number  to  display  (0  or  1 ). 

If  no  operands  are  specified,  the  command  displays  all  the  IP  addresses  configured  in  the  system.  For 
nonchassis-based  switches,  this  command  ignores  all  operands. 

Examples 

To  display  the  IP  address  for  logical  switch  0: 

switch : admin>  ipaddrshow  -sw  0 
Ethernet  IP  Address:  192.168.166.147 
Ethernet  Subnetmask:  255.255.255.0 
Fibre  Channel  IP  Address :  0.0.0.0 
Fibre  Channel  Subnetmask :  0.0.0.0 

See  also 

ipAddrSet 
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islShow 

Displays  ISL  information. 

Synopsis 

islshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  connections  and  status  of  the  ISL  of  each  port  on  this  switch.  The 
WWN  to  which  the  ISL  is  connected,  the  speed  of  the  connection,  and  whether  this  ISL  is  trunked  are 
displayed. 

Operands 

none 

Examples 

To  display  the  ISL  connections  for  the  switch: 


switch 

:adinin>  islshow 

1:  33 

->  29        10 : 00 : GO : 60 

69  : 

80 

4f : 

84 

switch 

sp: 

2G 

bw: 

4G 

TRUNK 

2:  39 

->     7  10:00:00:60 

69  : 

80 

4f : 

84 

switch 

sp: 

2G 

bw: 

8G 

TRUNK 

3  :  41 

->  (incompatible) 

4  :  47 

->  (incompatible) 

5:  57 

->  25        10 : 00 : 00 : 60 

69  : 

80 

4f  : 

84 

switch 

sp: 

2G 

bw: 

4G 

TRUNK 

6:  60 

->     2  10:00:00:60 

69  : 

80 

4f  : 

84 

switch 

sp: 

20 

bw: 

4G 

TRUNK 

See  also 

switchShow 
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item  List 

Lists  parameter  syntax  information. 

Synopsis 

item_list  =  element   \  element  white  item_list 
element  =  item   \    item  -  item 

item  =  num   \    slot    [   white  ]    I    [   white  ]  num 

slot  =  num 

num  =  hex  \  int 

int  =  int  digit   \  digit 

hex  =  Ox  hex  digit   \   hex  hex  digit 

digit  =  0|1|2|3|4|5|6|7|8|9 

hex  digit  =  digit  |A|B|c|D|E|F|a|b|c|d|e|f 
white  =  *  ["\t\f \r  ,"] 

Description 

All  kernel  diagnostics  have  at  least  one  item  list  parameter  to  specify  which  ports  to  test.  The  normal 
default  value  for  this  parameter  is  to  select  everything. 


NOTE:    This  is  not  a  command;  rather,  it  is  a  common  parameter  to  many 


commands. 


If  you  want  to  restrict  the  items  to  be  tested  to  a  smaller  set,  the  parameter  value  is  an  item  list  with  the 
following  characteristics: 

•  It  is  a  comma-separated  list  of  items. 

•  Each  item  in  the  list  might  be  a  single  element  or  a  range  of  elements  indicated  by  a  hyphen  (-)  and 
be  mixed  with  individual  values. 

•  Spaces  and  tab  stops  are  skipped. 

•  Each  item  might  be  preceded  by  an  optional  slot  number  and  foward  slash  (/). 

For  example,  0,3,4-6,1;  0,1,3,4,5,6;  and  0  3  4-6  1  each  select  items  0,  1 ,  3,  4,  5,  6 
Besides  the  syntax  rules,  there  are  also  some  grammatical  restrictions  on  the  slot  numbers: 

•  Once  specified,  a  slot  selection  applies  to  all  items  to  the  right  of  the  slot  selections  until  the  next  slot 
selection  or  the  end  of  the  item  list.  For  example,  1/0  -  15  and  1/0  -  1/15  are  equivalent. 

•  If  no  slot  number  is  specified,  user  port  lists  are  specified  by  area  number.  For  instance,  0  ,   16 ,  32 
and  1/0,   2/0,   3/0  specify  the  same  ports  on  a  1 6-port/blade  system.  On  that  same  system, 
1/0 ,   16 ,   32  is  not  a  valid  list:  even  though  it's  syntax  is  legal,  the  ports  do  not  exist. 

•  If  no  slot  number  is  specified,  all  lists  except  user  port  lists  will  use  the  default  slot  0. 

•  No  list  type  except  for  user  port  lists  might  specify  multiple  conflicting  slot  numbers.  For  instance,  1  /  0 , 
2/0,   3/0  is  a  valid  user  port  list  but  is  not  valid  for  any  other  type  of  list. 
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•    In  the  case  of  conflicting  settings  within  a  single  item  list,  an  error  is  generated,  as  described  earlier.  In 
the  case  of  multiple  item  list  parameters,  the  last  one  on  the  command  line  overrides  previous  settings. 

The  exact  type  of  list  varies,  depending  on  the  test  and  the  parameter;  hovvever,  the  most  common  are 
blade  ports  and  user  ports.  A  list  of  blade  ports  is  most  commonly  used  by  ASIC-level  tests  such  as 
cmiTest  or  turboRamTest  and  represents  which  ports  on  the  current  blade  (specified  with  --slot  # 
parameter)  are  tested.  A  list  of  user  ports  is  used  by  the  higher-level  tests,  such  as  spinSilk  or 
crossPortTest,  to  specify  which  user-accessible  external  ports  within  the  current  switch  (selected 
during  telnet  login)  are  tested.  When  specified  in  an  item  list,  user  ports  might  be  specified  by  either  the 
area  portion  of  the  ports  Fibre  Channel  address  or  with  slot/ port  notation.  For  nonblade  systems,  the  port 
number  on  the  silkscreen  is  the  area  number,  so  the  two  notations  are  identical. 

The  exact  type  of  list  required  for  any  input  parameter  might  be  determined  with  the  diagCommandShow 
command.  For  item  list  parameters,  the  parameter  type  is  PT_LIST  and  the  list  type  is  one  of  those  shown 
In  Table  1 6. 


Table  16    Object  descriptions 


Type 

Grouping 

Description 

BPORTS 

Blade 

Blade  ports,  internal  and  external  ports 

U  PORTS 

Sv/itch 

User  ports,  ports  v/ith  external  connections 

QUADS 

Blade 

Quadrants,  group  of  (normally  four)  ports 

CHIPS 

Blade 

Chips,  ASICs  within  a  blade 

MINIS 

Blade 

Mini-switches 

SLOTS 

Chassis 

Slots 

INDEX 

n.a. 

Anything 

See  also 

backport 
camTest 

centralMemoryTest 

cmemRetentionTest 

cmiTest 

crossPortTest 

diagCornmandShow 

portLoopbackTest 

portRegTest 

spinSilk 

sramRetentionTest 
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killTelnet 

Terminates  an  open  telnet  session. 

Synopsis 

killtelnet 

Availability 

admin 

Description 

Use  this  command  to  terminate  an  open  telnet  session.  The  killTelnet  command  is  an  interactive 
menu-driven  command.  Upon  invocation,  it  lists  all  the  current  telnet  and  serial  port  login  sessions.  It  lists 
information  such  as  the  session  number,  login  name,  idle  time,  IP  address  of  the  connection,  and 
timestamp  of  v/hen  the  login  session  v/as  opened.  A  prompt  is  then  displayed,  at  v/hich  point  you  can 
specify  the  session  number  of  the  connection  you  want  to  terminate. 


\^^}f  NOTE:  The  list  of  open  sessions  displayed  with  killTelnet  includes  the  user's  current  session.  Make 
C— I    sure  you  do  not  kill  your  own  telnet  session. 


Examples 

To  terminate  an  open  telnet  connection: 


switch : admin>  killtelnet 

Collecting  login  inf ormation . . . . Done 

List  of  telnet  sessions   (3  found) 

Session  No          USER                     TTY                          IDLE  FROM 

LOGIN© 

0                  rootO                ttySO  1:17m 

5 

13pm 

1                  aditiinO              pts/0                  16.00s  192.168. 

130  .29 

6 

2  9pm 

2                  aditiinO              pts/1                  3.00s  192.168. 

130  .29 

6 

31pm 

Enter  Session  Number  to  terminate   (q  to  quit)  1 

Collecting  process  information...  Done. 

You  have  opted  to  terminate  the  telnet  session: - 

logged  in  as   "adminO   ",    from  "192.168.130.29 

since  "   6:29pm"  and  has  been  inactive  for  "16 

.00s  ", 

the  current  command  executed  being:    "-rbash  " 

The  device  entry  is:    "pts/0  ". 

This  action  will  effectively  kill  these  process { es ): - 

USER                  PID  ACCESS  COMMAND 

/dev/pts/0                      root            12868  f....  login 

root            12869  f . . . .  login 

root            12877  f . . . .  rbash 

(continued  on  next  page) 
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Please  Ensure   (Y/ [N] ) :  y 
killing  session. . . .  Done! 
Collecting  login  inf ormation . . . . Done 

List  of  telnet  sessions    (2  found) 

Session  No 

USER                    TTY  IDLE 

FROM 

LOGINO 

0 

1 

rootO                ttySO  1:17m 
adminO              pts/1  3.00s 

192 . 168 . 130 .29 

5 : 13pm 
6 : 3 1pm 

Enter  Session 

Number  to  terminate   (q  to  quit)  q 

See  also 

none 
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licenseAdd 

Adds  license  keys  to  switch. 

Synopsis 

licenseadd  "license 

Availability 

admin 

Description 

Use  this  command  to  add  license  keys  to  the  system. 

Some  features  of  the  switch  and  the  fabric  to  which  it  is  connected  are  optional,  licensed  products. 
Without  a  license  installed  for  such  products,  their  services  are  not  available. 

A  license  key  is  a  string  of  approximately  1 6  upper-  and  lowercase  letters  and  numbers.  Case  is 
significant. 

The  license  must  be  entered  into  the  system  exactly  as  issued.  If  entered  incorrectly,  the  license  might  be 
accepted  but  the  licensed  products  will  not  function.  After  entering  the  license,  use  the  licenseShow 
command  to  check  for  correct  function.  If  no  licensed  products  are  shown,  then  the  license  is  invalid. 

After  entering  a  license,  the  licensed  product  is  available  immediately  and  the  system  does  not  need  to  be 
rebooted.  There  is  an  exception.  For  a  trunking  license  to  become  effective,  the  trunk  ports  need  to  be 
refreshed  using  the  commands  portDisable  and  portEnable  or  the  switch  must  be  refreshed  using 
the  commands  switchDisable  and  switchEnable. 

Operands 

This  command  has  the  following  operand: 

license  Specify  a  license  key,  in  quotation  marks.  This  operand  is 

required. 

Examples 

To  add  a  license  key  to  the  switch: 

switch : admin>  licenseadd  "aBcDeFGhl2345 " 
adding  license  key  " aBcDeFGhl2345 " 


See  also 


licenseRemove 
licenseShow 
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licenseHelp 

Displays  commands  used  to  administer  license  keys. 

Synopsis 

licensehelp 

Availability 

all  users 

Description 

Use  this  command  to  display  a  list  of  the  commands  used  to  administer  license  keys. 

Operands 

none 

Examples 

To  display  license  commands: 


See  also 


switch :  adinin> 

licensehelp 

licenseAdd 
licenseldShow 
licenseRemove 
licenseShow 

Add  a  license  to  this  switch 
Show  system  license  ID 
Remove  a  license  from  this  switch 
Show  current  licenses 

licenseAdd 

licenseldShow 

licenseRemove 

licenseShow 
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licenseldShow 

Displays  system  license  ID. 

Synopsis 

licenseidshow 


Availability 

all  users 

Description 

Use  this  command  to  display  the  license  ID  of  the  system. 

Some  features  of  the  switch  and  the  fabric  are  optional,  licensed  products.  Without  a  license  installed  for 
such  products,  the  services  provided  by  these  features  are  not  available. 

For  dual-domain  systems,  a  single  license  enables  both  logical  switches  to  use  these  products.  The  chassis 
is  assigned  a  license  ID  from  which  a  license  is  generated.  Such  licenses  are  locked  and  are  only 
functional  on  the  specific  system  for  which  they  were  issued. 

This  command  displays  to  standard  output  the  system  license  ID  used  for  both  generating  and  validating 
licenses  on  the  system.  The  license  ID  format  is  eight  pairs  of  hexadecimal  values,  separated  by  colons. 
Each  hexadecimal  value  is  between  00  (0)  and  FF  (255). 


NOTE:    While  the  format  of  this  identifier  might  be  similar  or  even  identical  to  other  identifiers  in  the 
system,  no  inferences  should  be  made  about  the  relationships  between  them  as  they  are  subject  to  change 
independently  of  one  another. 


Operands 

none 

Examples 

To  display  the  license  ID: 

switch : admin>  licenseidshow 
a4:f8:69:33:22:00:ea:18 

See  also 

licenseAdd 
licenseHelp 
licenseRemove 
licenseShow 
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licenseRemove 


Removes  the  license  key  from  the  system. 

Synopsis 

licenseremove  "license 

Availability 

admin 

Description 

Use  this  command  to  remove  an  existing  license  key  from  a  sv/itch.  The  existing  license  key  must  be 
entered  exactly  as  shown  by  licenseShow,  including  case. 

When  the  key  has  been  entered,  use  the  licenseShow  command  to  verify  that  the  key  has  been 
removed  and  the  licensed  product  uninstalled. 

After  removing  a  license  key,  the  sv/itch  must  be  rebooted.  With  no  license  key,  licenseShow  displays 
No  licenses. 

Operands 

The  following  operand  is  required: 

license  Specify  the  license  key,  in  quotation  marks.  This  operand  is 

required. 

Examples 

To  remove  a  license  key  from  the  switch: 

switch : admin>  licenseremove  "bQebzbRdScRf cOiK" 
removing  license  key  "bQebzbRdScRf cOiK" 

See  also 

licenseAdd 
licenseHelp 
licenseldShow 
licenseShow 
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licenseShow 

Displays  current  license  keys. 

Synopsis 

licenseshow 

Availability 

all  users 

Description 

Use  this  command  to  display  current  license  keys,  along  with  a  list  of  licensed  products  enabled  by  these 
keys.  The  message  No  license  installed  on  this  switch  is  displayed  when  no  licenses 
are  installed. 

Operands 

none 

Examples 

To  display  the  installed  license  keys  on  a  switch: 

switch : admin>  licenseshow 
bQebzbRdScRf cOiK: 

Web  license 

Zoning  license 
SybbzQQ9edTzccOX: 

Fabric  license 

See  also 

licenseAdd 
licenseHelp 
licenseldShow 
licenseRemove 
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linkCost 


Sets  or  prints  the  fabric  shortest  path  first  (FSPF)  cost  of  a  link. 

Synopsis 

linkcost    [slotnumber/]  [portnumber]  [,  cost] 

Availability 

admin 

Description 

Use  this  command  to  set  or  display  the  cost  of  an  inter-switch  link  (ISL).  The  cost  of  a  link  is  a  dimensionless 
positive  number.  The  FSPF  protocol  compares  the  cost  of  various  paths  betv/een  a  source  svvitch  and  a 
destination  svvitch  by  adding  the  costs  of  all  the  ISL's  along  each  path.  FSPF  chooses  the  path  with 
minimum  cost.  If  multiple  paths  exist  with  the  same  minimum  cost,  FSPF  employs  load  sharing  over  these 
paths. 

Every  ISL  has  a  default  cost  that  is  inversely  proportional  to  its  bandwidth.  For  a  1-Gb/s  ISL,  the  default 
cost  is  1 000.  For  a  2-Gb/s  ISL,  the  default  cost  is  500. 

This  command  can  be  used  to  set  a  non-default,  static  cost  for  any  port. 

When  executed  without  arguments,  this  command  displays  the  current  cost  of  each  port  on  the  switch, 
even  those  are  not  ISL's.  Active  ISLs  have  an  additional  suffix  of  E  PORT  attached  to  their  interface 
number.  If  the  port  has  a  static  cost  assigned  to  it,  then  the  suffix  of  STATIC  is  appended  to  the  link  cost.  In 
this  case,  only  the  current  link  cost  is  displayed. 

Use  interf  aceShow  to  display  both  the  default  and  current  link  costs. 

To  remove  a  static  cost  from  the  database,  execute  this  command  with  a  costoi  zero  on  the  desired  port. 
This  port  will  then  revert  to  its  default  link  cost. 


\^^}f  NOTE:  Valid  cost  values  are  0  to  32767.  Assigning  a  value  outside  this  range  saves  and  displays  an 
C— I    abnormal  linkcost. 


Operands 

This  command  has  the  following  operands: 

slotnumber  Specify  the  slot  number  for  a  Core  Switch  2/ 64  or  SAN  Director 

2/1  28.  For  all  other  switches,  this  operand  is  not  required.  The 
slot  number  must  be  followed  by  a  slash  (  /  )  and  the  port 
number,  so  that  each  port  is  represented  by  both  slot  number  (1 
through  4  or  7  through  10)  and  port  number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of 
1 0  slots.  Slot  numbers  5  and  6  are  control  processor  cards;  slots 
1  through  4  and  7  through  1 0  are  port  cards.  On  each  port 
card,  there  are  16  ports,  counted  from  the  bottom,  numbered  0 
to  15. 

Specify  the  port's  link  cost  to  change  or  display.  Valid  values  for 
portnumber  wary,  depending  on  the  switch  type.  This  operand 
is  optional;  if  omitted,  the  cost  of  all  post  is  displayed. 

Specify  the  new  cost  of  the  link  connected  to  the  specified  port 
number.  This  operand  is  optional. 


portnumber 


cost 
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If  no  operands  are  specified,  the  current  values  for  all  ports  on  the  (logical)  switch  are  displayed. 

Examples 

To  display  the  cost  of  a  link  and  set  that  cost: 
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1  n  n  n 
-L  u  u  u 

2 

9 

1000 

A 

1  n  n  n 
-L  U  U  U 

2 

11  (E_PORT) 

2000 

(STATIC) 

A 

1  n  n  n 
J-  U  U  U 

2 

13 

1000 

2 

14 

1000 

15 

1000 

switch: 

:  acimin>  linkcost 

2/4  500 

switch: 

:  adinin>  linkcost 

2/4 

Slot 

2                Interface  4 

Cost 

500  (STATIC) 

switch: 

;  adinin>  linkcost 

2/4  0 

Slot 

2                Interface  4 

Cost 

1000 

See  also 

interf aceShow 
LSDbShow 
topologyShow 
urouteShow 
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login 

Logs  in  as  new  user. 

Synopsis 

login 

Availability 

all  users 

Description 

Use  this  command  to  log  in  to  the  switch  with  another  user  name  and  password,  without  first  logging  out 
from  the  original  session.  If  the  user  was  originally  connected  using  a  telnet  or  riogin  session,  that  session 
is  left  open. 

This  command  allows  you  to  access  commands  that  you  cannot  access  at  your  current  user  level. 
Operands 

none 

Examples 

To  log  in  as  admin  from  the  login  user: 

switch:user>  login 
login:  admin 
Password : xxxxxx 

See  also 

logout 


Fabric  OS  5.0.0  command  reference  guide  303 


logout 

Logs  out  from  a  telnet,  riogin,  or  serial  port  session. 

Synopsis 

logout 

Availability 

all  users 

Description 

Use  this  command  to  log  out  from  a  telnet,  riogin,  or  serial  port  session.  Telnet  and  riogin  connections  are 
closed  and  tfie  serial  port  returns  to  the  login:  prompt. 

The  exit  command  is  accepted  as  a  synonym  for  logout,  as  is  Ctrl-D  at  the  beginning  of  a  line. 

NOTE:    If  you  close  a  telnet  or  sectelnet  session  by  clicking  the  "X"  in  the  upper-right  corner,  the  window 
closes  but  the  session  stays  open  until  it  times  out.  Trying  to  open  another  session  before  the  timeout  has 
completed  causes  an  error  message  to  display. 


Operands 

none 

Examples 

To  log  out  from  an  riogin  session: 

switch : admin>  logout 
Connection  to  host  lost. 

See  also 

login 
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loopPortTest 

Functional  test  of  L_Port  M->M  path  on  a  loop. 


Synopsis 

loopporttest  [-nframes  count] [-ports  itemlist] 
[-seed  payload_pattern]  [-width  pattern_width] 


Availability 

admin 


Description 

Use  this  command  to  verify  the  operation  of  the  switch  by  sending  frames  from  port  M's  transmitter  and 
looping  the  frames  back  through  an  external  fiber  cable,  including  all  the  devices  on  the  loop,  into  port 
M's  receiver.  This  exercises  all  the  sv/itch  components,  from  the  main  board,  to  the  SFP,  to  the  fiber  cable, 
to  the  SFPs  (of  the  devices  and  the  sv/itch),  and  back  to  the  main  board. 

The  cables  and  SFPs  connected  should  be  of  the  same  technology,  meaning  that  a  short  wavelength  SFPed 
(switch)  port  is  connected  to  another  short  wavelength  SFPed  (device)  port  through  a  short  wavelength 
cable;  and  a  long  wavelength  port  is  connected  to  a  long  wavelength  port;  and  a  copper  port  is 
connected  to  a  copper  port. 

Only  one  frame  is  transmitted  and  received  at  any  one  time.  The  port  LEDs  flicker  green  rapidly  while  the 
test  is  running. 

The  test  method  is  as  follows: 

1.  Determine  which  ports  are  L_Ports. 

2.  Enable  ports  for  cabled  loopback  mode. 

3.  Create  a  frame  F  of  data  size  (1 024  bytes). 

4.  Transmit  frame  F  through  port  M,  with  DJD  to  the  FL_Port  (AL_PA  =  0). 

5.  Pick  up  the  frame  from  port  M,  the  FL_Port. 

6.  Check  if  any  of  the  eight  statistic  error  counters  are  nonzero:  ENC_in,  CRC_err,  TruncFrm,  FrmTooLong, 
BadEOF,  Enc_out,  BadOrdSet,  DiscC3. 

7.  Check  if  the  transmit,  receive,  or  class  3  receiver  counters  are  stuck  at  some  value. 

8.  Check  if  the  number  of  frames  transmitted  is  not  equal  to  the  number  of  frames  received. 

9.  Repeat  step  3  through  step  8  for  all  ports  present  until  either  the  number  of  frames  requested  is 
reached  or  all  ports  are  marked  bad. 

You  can  specify  a  payload  pattern  to  be  used  when  executing  this  test.  If  the  pattern  is  not  specified,  then 
at  every  30  passes,  a  different  data  type  is  used  to  generate  a  new  pattern  to  create  the  frame.  The  data 
pattern  is  generated  based  on  each  data  type.  Some  data  types  might  generate  different  data  patterns  on 
every  pass.  The  data  types  are  repeated  every  210  pass. 

Operands 

This  command  has  the  following  operands: 

-nframes  count  Specify  the  number  of  times  (or  number  of  frames  per  port)  to 

execute  this  test.  The  default  value  is  1 0. 

-ports  itemlist  Specify  a  list  of  user  ports  to  test.  By  default,  all  user  ports  in  the 

current  slot  are  tested.  Refer  to  itemList  for  more  information 
on  selecting  ports. 
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-seed  payload _pattern        Specify  the  seed  pattern  of  ttie  test  packets.  The  data  types  are: 


1 

CSPAT 

0x7e,  0x7e,  0x7e,  0x7e, 

2 

BYTE_LFSR 

0x69,  0x01,  0x02,  0x05, 

3 

CHALF_SQ 

Ox4a,  Ox4a,  Ox4a,  Ox4a, 

4 

QUAD_NOT 

0x00,  Oxff,  0x00,  Oxff,  ... 

5 

CQTR_SQ 

0x78,  0x78,  0x78,  0x78, 

6 

CRPAT 

Oxbc,  Oxbc,  0x23,  0x47  . 

7 

RANDOM 

0x25,  0x7f,  0x6e,  0x9a, 

-width  pattern_width  Specify  the  width  of  the  test  pattern.  Valid  values  include: 

•  1  for  byte 

•  2  for  word 

•  3  for  quad 

This  operand  is  optional. 

Examples 

To  perform  a  loopback  port  test: 

switch : admin>  loopporttest  -ports  1/0-1/15 

Running  Loop  Port  Test   

Test  Complete:    "loopporttest"  Pass  10  of  10 
Duration  0  hr,    0  itiin  &  1  sec  (0:0:0:127). 
passed. 
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Diagnostics 

Following  are  possible  error  messages  if  failures  are  detected: 

DATA 
INIT 

PORT_DIED 

EPI 1_STATUS_ERR 


ERR_ 

.STAT 

ERR_ 

.STATS 

ERR_ 

_STATS_2L0NG 

ERR_ 

_STATS_BADEOF 

ERR_ 

.STATS_BADOS 

ERR_ 

.STATS_C3DISC 

ERR_ 

.STATS_CRC 

ERR_ 

.STATS_ENCIN 

ERR_ 

_STATS_ENCOUT 

ERR_ 

_STATS_TRUNC 

ERR_ 

_STAT_2L0NG 

ERR_ 

.STAT_BADEOF 

ERR_ 

.STAT_BADOS 

ERR_ 

.STAT_C3DISC 

ERR_ 

_STAT_CRC 

ERR_ 

_STAT_ENCIN 

ERR_ 

.STAT_ENCOUT 

ERR_ 

.STAT_TRUNC 

FDET_PERR 

FINISH_MSG_ERR 

FTPRT_STATUS_ERR 

LESSN_STATUS_ERR 

MBUF_STATE_ERR 

MBUF_STATUS_ERR 

NO_SEGMENT 

PORT_ABSENT 

PORT_ENABLE 

P0RT_M2M 

PORT_STOPPED 

PORT_WRONG 

RXQ_FRAME_ERR 

RXQ_RAM_PERR 

STATS 

STATS_C3FRX 

STATS_FRX 

STATS_FTX 

TIMEOUT 

XMIT 

Refer  to  tfie  HP  StorageWorks  Fabric  OS  4.x  system  error  messages  reference  guide  for  more  information. 
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See  also 

camTest 

centralMemoryTest 

cmemRetentionTest 

cmiTest 

crossPortTest 

itemList 

portLoopbackTest 

portRegTest 

spinSilk 

sramRetentionTest 
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LSDbShow 

Displays  the  Fabric  Shortest  Path  First  (FSPF)  link  state  database. 

Synopsis 

Isdbshow  [domain] 

Availability 

all  users 

Description 

Use  this  command  to  display  an  FSPF  link  state  database  record  for  switches  in  the  fabric,  or  one  domain 
within  it. 

There  are  two  types  of  database  entries: 

•  The  link  state  database  entry,  which  is  permanently  allocated. 

•  The  link  state  record  (LSR),  which  is  allocated  when  a  switch  is  connected  to  the  fabric. 

The  LSR  describes  the  links  between  connected  domains  in  a  fabric.  For  a  link  to  be  reported  in  the  LSR, 
the  neighbor  for  that  link  must  be  in  NB_ST_FULL  state. 

This  command  displays  the  content  of  both  types  of  database  entries,  if  both  are  present. 
The  fields  described  in  Table  1  7  display. 
Table  17    IsdbShow  display  fields 


Field 

Description 

Domain 

Domain  number  described  by  this  LSR.  A  (self)  keyword  after  the 
domain  number  indicates  that  LSR  describes  the  local  switch. 

IsrP 

Pointer  to  LSR. 

earlyAccLSRs 

Number  of  LSRs  accepted,  even  though  they  were  not  sufficiently 
spaced  apart. 

ignoredlSRs 

Number  of  LSRs  not  accepted  because  they  were  not  sufficiently 
spaced  apart. 

lastlgnored 

Last  time  an  LSR  was  ignored. 

installTime 

Time  this  LSR  was  installed  in  the  database,  in  seconds  since  boot. 

IseFlags 

Internal  variable. 

uOutlfs 

Internal  variable 

uPathCost 

Internal  variable. 

uOldHopCount 

Internal  variable. 

uHopsFromRoot 

Internal  variable. 

mOutlfs 

Internal  variable. 
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Table  17    IsdbShow  display  fields  (continued) 


Field 

Description 

parent 

Internal  variable. 

mPathCost 

Internal  variable. 

m  Hops  From  Root 

1    1          1  -LI 

Internal  vanable. 

1  A 

Is  Age 

Age,  in  seconds,  ot  this  LbK.  An  LbK  is  removed  trom  the  database 
v/hen  its  age  exceeds  3,600  seconds. 

reserved 

Reserved  for  future  use. 

type 

Type  of  the  LSR.  Alv/ays  1 . 

options 

Alv/ays  0. 

Isid 

ID  of  this  LSR.  It  is  identical  to  the  domain  number. 

advertiser 

ID  (domain  number)  of  the  sv/itch  that  originated  this  LSR. 

incarn 

1                !•                 1           f  1 1  ■     1  f  n 

Incarnation  number  ot  this  LbK. 

1  ii 
length 

■Till        il    /•     1     1     \     f  il  •    1  rn    III       1         1             1  |.    1     I  I 

lotal  length  (in  bytes)  ot  this  LbK.  Includes  header  and  link  state 
information  for  all  links. 

LI 

chksum 

/"L       1                  I  I    I    1  1  CD         -iL                  1-             I  1    A          I-    1  1 

Checksum  ot  total  LbK,  y/\m  exception  ot  IsAge  tield. 

I-  1  1 
linkCnt 

Kl        L         £  I-    1      ■     iL-     1  CD    c      L  I-    1                     1              ■  LL 

Number  ot  links  in  this  LbK.  bach  link  represents  a  neighbor  in 
NB_ST_FULL  state. 

fi 

tiags 

Always  0. 

1  •  III 
Linkld 

iniTil-l-lii-il        1           -              1           [il            -il           il         il  -1 

ID  ot  this  link.  It  is  the  domain  number  ot  the  sv/itch  on  the  other  side 
of  the  link. 

out  port 

Port  number  on  the  local  sv/itch. 

rem  port 

Port  number  of  the  port  on  the  other  side  of  the  link. 

cost 

Cost  of  this  link.  The  default  cost  for  a  1  Gb/sec  link  is  1 000. 

costCnt 

Alv/ays  0. 

type 

Alv/ays  1 . 

Operands 

This  command  has  the  following  operand: 

domain  Specify  the  domain  number  of  the  LSR  to  be  displayed.  This 

operand  is  optional;  if  omitted,  the  entire  link  state  database  is 
displayed. 
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Examples 

To  display  the  link  state  record  for  a  switch: 


switch :  adinin>  Isdbshow  1 


Link  State  Record: 


Link  State 

Record 

pointer 

=  0xl0053dlJ 

Is  Age 

16 

reserved 

0 

type 

1 

options 

0x0 

Isid 

1 

advertiser 

1 

incarn 

0x80000014 

length 

284 

chksum 

0x8453 

linkCnt  = 

16, 

flags 

=  0x0 

Linkid  = 

2  , 

out 

port 

16, 

rem 

port 

Linkid  = 

2  , 

out 

port 

17  , 

rem 

port 

Linkid  = 

2  , 

out 

port 

18, 

rem 

port 

Linkid  = 

2  , 

out 

port 

19, 

rem 

port 

Linkid  = 

2  , 

out 

port 

24, 

rem 

port 

Linkid  = 

2  , 

out 

port 

25, 

rem 

port 

Linkid  = 

2  , 

out 

port 

26, 

rem 

port 

Linkid  = 

2  , 

out 

port 

27  , 

rem 

port 

Linkid  = 

2  , 

out 

port 

32, 

rem 

port 

Linkid  = 

2, 

out 

port 

33, 

rem 

port 

48, 

cost 

=  500, 

costCnt 

=  0, 

type  = 

1 

49, 

cost 

=  500, 

costCnt 

=  0, 

type  = 

1 

50, 

cost 

=  500, 

costCnt 

=  0, 

type  = 

1 

51, 

cost 

=  500, 

costCnt 

=  0, 

type  = 

1 

56, 

cost 

=  500, 

costCnt 

=  0, 

type  = 

1 

57, 

cost 

=  500, 

costCnt 

=  0, 

type  = 

1 

58, 

cost 

=  500, 

costCnt 

=  0, 

type  = 

1 

59, 

cost 

=  500, 

costCnt 

=  0, 

type  = 

1 

0, 

cost 

=  500, 

costCnt 

=  0, 

type  = 

1 

1, 

cost 

=  500, 

costCnt 

=  0, 

type  = 

1 

(continued  on  next  page) 
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T  -1  -nVTrl  — 
J-i  J.iiJs.±U.  — 

z  , 

out  poirt  — 

rem 

port  — 

9 

z  , 

cost 

—  R  n  n 

n 

type  = 

T  -i  nVTH  — 

2  ^ 

1  "H             f~l  "K~  — 

UU.L-    yU-L  U  — 

port  — 

-J  / 

cost 

—  R  n  n 

1^ /~i  o        T*i  "1"  — 

n 

type  = 

T  -1  tiVT/-]  — 
J-i  J.iiJS.±(J.  — 

z  , 

U  U.  U    pO-L  L  — 

rem 

port  — 

±  z  , 

cost 

—  1=;  n  n 

—  D  U  U  , 

n 

type  = 

J- 

Linkid  = 

2  , 

out  port  = 

45, 

rem 

port  = 

13, 

cost 

=  500, 

costCnt  = 

0, 

type  = 

1 

Linkid  = 

2  , 

out  port  = 

46, 

rem 

port  = 

14, 

cost 

=  500, 

costCnt  = 

0, 

type  = 

1 

2, 

out  port  = 

47, 

rem 

port  = 

15, 

cost 

=  500, 

costCnt  = 

0, 

type  = 

J. 

The  local 

switch  has  sixteen 

links  in  NB_ 

_ST_FULL  state,  all  of  them 

are 

connected 

to 

switch  2 . 

See  also 

interf aceShow 
nbrStateShow 
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memShow 

Displays  the  amounts  of  free  and  used  memory  in  a  switch. 

Synopsis 

memshow   [   -b   |    -k   |    -m  ] 

Availability 

all  users 

Description 

Use  this  command  to  display  free  and  used  memory  in  the  switch,  as  well  as  the  shared  memory  and 
buffers  used  by  the  kernel. 

Operands 

This  command  has  the  following  operands: 

-b  Specify  to  display  memory  usage  in  bytes, 

-k  Specify  to  display  memory  usage  in  kilobytes, 

-m  Specify  to  display  memory  usage  in  megabytes. 

By  default,  memory  usage  is  displayed  in  bytes. 

Examples 

To  view  the  memory  usage: 


switch 

admin>  memshow 

total 

used 

free 

shared 

buffers 

cached 

Mem: 

129740800  112562176 

17178624 

0 

139264 

30396415 

Swap : 

0 

0 

0 

switch 

admin>  memshow 

-m 

total 

used 

free 

shared 

buffers 

cached 

Mem: 

123 

107 

16 

0 

0 

28 

Swap : 

0 

0 

0 

See  also 

saveCore 
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miniCycle 


Runs  a  functional  test  of  internal  and  external  transmit  and  receive  paths  at  full  speed. 


Synopsis 

mini cycle  [--slot  slotnumber]  [-nmegs  count]  [-lb_mode  mode]  [-spd_mode  mode] 
[-ports  itemlist] 


Use  this  command  to  verify  the  intended  functional  operation  of  an  ASIC  pair  (minisv/itch)  at  the  maximum 
or  selected  speed  by  setting  up  the  routing  hardware  so  that  frames  received  by  port  M  are  retransmitted 
by  v/ay  of  port  N.  Likev/ise,  frames  received  by  port  N  are  retransmitted  by  way  of  port  M.  Each  port  M 
sends  tv/o  frames  to  its  partner,  port  N. 

This  test  is  run  as  a  series  of  eight  path  tests.  Each  port  on  the  ASIC  pair  is  exchanging  frames  with  one 
port  on  the  adjacent  ASIC  in  the  same  miniswitch.  At  the  end  of  a  path  test,  the  frames  are  captured  and 
the  routing  is  changed  so  that  each  port  exchanges  frames  with  the  next  port  on  the  adjacent  ASIC  of  the 
same  miniswitch. 

Unlike  implementation  of  the  spinSilk  command,  a  port  is  only  exchanging  frames  with  one  other  port 
at  a  time  under  the  miniCycle  command.  Just  like  with  spinSilk,  all  ports  are  active  and  exchanging 
frames  simultaneously  with  miniCycle. 

The  path  number  being  tested  determines  the  partner  port  N  for  each  port  M  (bold  and  italicized  in  the 
following  example): 


path 

0  : 

0-8, 

1 

-9, 

2 

-10, 

3 

-11, 

4 

-12  , 

5 

-13, 

6 

-14, 

7 

-15 

path 

1  : 

7-8, 

0 

-9, 

1 

-10, 

2 

-11, 

3 

-12  , 

4 

-13, 

5 

-14, 

6 

-15 

path 

2  : 

6-8, 

7 

-9, 

0 

-10, 

1 

-11, 

2 

-12  , 

3 

-13, 

4 

-14, 

5 

-15 

path 

3  : 

5-8, 

6 

-9, 

7 

-10, 

0 

-11, 

1 

-12  , 

2 

-13, 

3 

-14, 

4 

-15 

path 

4  : 

4-8, 

5 

-9, 

6 

-10, 

7 

-11, 

0 

-12, 

1 

-13, 

2 

-14, 

3 

-15 

path 

5  : 

3-8, 

4 

-9, 

5 

-10, 

6 

-11, 

1 

-12  , 

0 

-13, 

1 

-14, 

2 

-15 

path 

6  : 

2-8, 

3 

-9, 

4 

-10, 

5 

-11, 

6 

-12  , 

7 

-13, 

0 

-14, 

1 

-15 

path 

7  : 

1-8, 

2 

-9, 

3 

-10, 

4 

-11, 

5 

-12  , 

6 

-13, 

1 

-14, 

0 

-15 

f^)f  NOTE:    The  port  numbers  are  relative  to  the  ASIC  pair.  This  test  does  not  route  frames  from  one  ASIC-pair 


Ports  cabled  to  other  ports  fail  if  port  loopback  mode  is  selected,  and  the  port  must  have  media  and 
loopback  plugs  installed.  For  best  coverage,  you  should  use  self-loopback  plugs  and  port  loopback  mode 
(-lb_mode  l),  as  each  port's  external  connectivity  will  be  tested. 

The  frames  are  continuously  transmitted  and  received  in  all  ports  in  parallel.  The  port  LEDs  flicker  green 
rapidly  while  the  test  runs. 

The  path  test  method  is  as  follows: 

1 .  Clear  port  statistics  and  error  counters. 

2.  Enable  ports  for  specified  self-loopback  mode. 


Availability 


admin 


Description 
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3.  Configure  up  the  routing  table  so  that  when  port  M  receives  frames,  the  frames  are  routed  back  to  the 
partner  port  N  and  vice  versa. 

4.  Transmit  two  frames  by  way  of  port  M  and  two  frames  by  way  of  port  N.  The  following  four  patterns 
will  be  used  for  the  four  frames,  one  pattern  each: 

•  1 000  bytes  of  CS  PAT 

•  480  bytes  of  RDRAM_PAT 

•  21  12  bytesof  BYTE_LFSR 

•  200  bytes  of  RANDOM 

5.  Periodically  check  status: 

a.  Each  port  has  not  died. 

b.  Each  port's  frames-transmitted  counter  is  still  incrementing. 

c.  Each  port's  statistic  error  counters  are  nonzero: 

d.  ENCjn,  CRC_err,  TruncFrm,  FrmTooLong,  BadEOF,  Enc_out,  BadOrdSet,  DiscC3 

e.  Until  one  of  the  following  is  met: 

•  The  number  of  frames  requested  is  met  on  all  selected  ports. 

•  All  ports  are  eventually  marked  bad. 

•  The  user  aborts  the  procedure. 

The  path  test  is  repeated  for  each  path,  unless  it  is  aborted  by  a  keyboard  interrupt.  The  data  is  not  read 
and  checked  as  was  done  in  portLoopbackTest  and  crossPortTest.  There  is  no  CPU  intervention 
during  a  path  test  besides  the  periodic  checks  of  the  hardware  counters.  At  the  end  of  a  path  test,  all 
statistics  and  routes  are  reset  for  the  next  path  test. 

An  example  of  the  data  used  is  as  follows: 

CSPAT:  0x7e,  0x7e,  Ox7e,  Ox7e,  ... 

RDRAM_PAT:  Oxff,  0x00,  Oxff,  0x00,  ... 

BYTE_LFSR:  0x69,  0x01,  0x02,  0x05,  ... 

RANDOM:  0x25,  Ox7f,  0x6e,  0x9a,  ... 

Because  this  test  includes  the  media  and  the  fiber  cable  loopback  plug  in  its  test  path,  its  results  combined 
with  the  results  of  portLoopbackTest  and  spinSilk  can  be  used  to  determine  which  components  of  the  switch 
are  faulty. 


Operands 


The  following  operands  are  optional: 


-lb_mode  mode 


--slot  slotnumber 


-nmegs  count 


Specifies  the  slot  number  on  which  the  diagnostic  operate.  The  ports 
specified  are  relative  to  this  slot  number.  The  default  is  set  to  0  and 
designed  to  operate  on  fixed-port-count  products. 

Specifies  the  number  of  million  frames  to  send  per  path  test.  The  path 
test  will  progress  until  the  specified  number  of  frames  has  been 
transmitted  on  each  port.  The  default  value  for  count  is  1 ,  so  the  total 
number  of  frames  sent  will  be  at  least  8  million  (1  million  frames  *  8 
paths). 

Selects  the  loopback  point  for  the  test.  By  default,  miniCycle  uses 
external  (SERDES)  loopback. 

1  Port  Loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 
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5  Internal  (parallel)  loopback 

7  Backend  bypass  and  port  loopback 

8  Backend  bypass  and  SERDES  loopback 

9  Backend  bypass  and  internal  loopback 


-spd_mode  mode        Specifies  the  speed  mode  for  the  test.  This  parameter  is  only  used  for 

Bloom  and  Condor  ASIC-based  products,  for  which  this  parameter 
controls  the  speed  at  which  each  port  operates.  For  IG-only  products, 
this  parameter  is  ignored.  The  exact  operation  of  modes  5  through  8 
depends  on  the  loopback  mode  selected.  When  speed  modes  5 
through  8  are  used  with  cables,  they  must  be  connected  EVEN->ODD 
or  the  test  fails. 

0  Run  test  at  both  1  Gb/s,  2  G.bit/sec,  and  4  Gb/s 
(default). 

1  Set  all  port  speeds  to  lock  at  1  Gb/s. 

2  Set  all  port  speeds  to  lock  at  2  Gb/s. 

4  Set  all  port  speeds  to  lock  at  4  Gb/s. 

For  -lb_mode  set  to  1,  the  following  speed  modes  are  available  to 
test  the  speed  negotiation. 

3  Set  all  even  ports'  speed  for  auto-negotiate.  Set  all  odd 

ports'  speed  for  1  Gbps. 

4  Set  all  even  ports'  speed  for  auto-negotiate.  Set  all  odd 
ports'  speed  for  2  Gbps. 

5  Set  all  odd  ports'  speed  for  auto-negotiate.  Set  all  even 
ports'  speed  for  1  Gbps. 

6  Set  all  odd  ports'  speed  for  auto-negotiate.  Set  all  even 

ports'  speed  for  2  Gbps. 

For  -lb_mode  set  to  2,  the  following  speed  modes  are  available  to 
test  FIFO  underrun. 

3.5  Set  all  even  ports'  speed  for  2  Gbps.  Set  all  odd  ports' 
speed  for  1  Gbps. 

4.6  Set  all  even  ports'  speed  for  1  Gbps.  Set  all  odd  ports' 
speed  for  2  Gbps. 

-ports  itemlist      Specifies  a  list  of  blade  ports  to  test.  By  default,  all  the  blade  ports  in 
the  specified  slot  (--slot)  are  used.  Refer  to  itemlist  for  further 
details.  If  all  ports  in  the  ASIC  pair  are  not  specified,  only  paths 
between  selected  ports  are  tested. 

ASIC-pair  0:  -ports  0-15 

ASIC-pair  1:  -ports  16-31 

ASIC-pair  2:  -ports  32-47 

ASIC-pair  3:  -ports  48-63 
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Examples 

To  run  a  functional  test  on  slot  1  using  external  (SERDES)  loopback: 

switch : adinin>  minicycle  --slot  1  -lb_mode  2 


Running  minicycle 


One  moment 

please  .  .  . 

Path 

0   .  .  . 

Spinning  . . . 

Path 

1  ... 

Spinning  . . . 

Path 

2  ... 

Spinning  . . . 

Path 

3  ... 

Spinning  . . . 

Path 

4  ... 

Spinning  . . . 

Path 

5   .  .  . 

Spinning  . . . 

Path 

6   .  .  . 

Spinning  . . . 

Path 

7  ... 

Spinning   . . . 

Test 

Complete:  minicycle  Pass  1  of  1 

Duration  0 

hr,    1  min  &  4  sec  (0:1:4:409). 

passed. 

To  run  a  functional  test  on  ports  0,  1,  2,  and  8  using  port  loopback: 

switch : admin>  minicycle  -ports  0,1,2,8  -lb_mode  1 

Back 

Plane 

Loop  Back  mode  is  ON. 

Running  mini  Cycle   

One  moment 

please  .  .  . 

Path 

0   .  .  . 

Spinning  . . . 

Path 

1  ... 

skipped. 

Path 

2  ... 

skipped. 

Path 

3  ... 

skipped. 

Path 

4  ... 

skipped. 

Path 

5   .  .  . 

skipped. 

Path 

6   .  .  . 

Spinning  . . . 

Path 

7  ... 

Spinning  . . . 

Test 

Complete:    "minicycle"  Pass  1  of  1 

Duration  0 

hr,    0  min  &  23  sec  (0:0:23:100). 

passed. 
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Diagnostics 

When  it  detects  failure(s),  the  test  reports  one  or  more  of  the  following  error  messages: 

DATA 

EPIl_STATUS_ERR 


ERR_ 

_STATS_2L0NG 

ERR_ 

.STATS_BADEOF 

ERR_ 

.STATS_BADOS 

ERR_ 

.STATS_C3DISC 

ERR_ 

_STATS_CRC 

ERR_ 

_STATS_ENCIN 

ERR_ 

.STATS_ENCOUT 

ERR_ 

.STATS_TRUNC 

ERR_ 

.STAT_2L0NG 

ERR_ 

.STAT_BADEOF 

ERR_ 

_STAT_BADOS 

ERR_ 

_STAT_C3DISC 

ERR_ 

_STAT_CRC 

ERR_ 

.STAT_ENCIN 

ERR_ 

.STAT_ENCOUT 

ERR_ 

.STAT_TRUNC 

FDET_PERR 
FINISH_MSG_ERR 
FTPRT_STATUS_ERR 
INIT 

LESSN_STATUS_ERR 

MBUF_STATE_ERR 

MBUF_STATUS_ERR 

NO_SEGMENT 

PORT_ABSENT 

PORT_DIED 

PORT_ENABLE 

P0RT_M2M 

PORT_STOPPED 

PORT_WRONG 

RXQ_FRAME_ERR 

RXQ_RAM_PERR 

STATS 

STATS_C3FRX 

STATS_FRX 
STATS_FTX 
TIMEOUT 
XMIT 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 
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See  also 

backport 
camTest 

centralMemoryTest 

cmemRetentionTest 

cmiTest 

crossPortTest 

itemList 

portLoopbackTest 

portRegTest 

spinSilk 

sramRetentionTest 
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minisPropShow 

Displays  ASIC  pair  properties. 

Synopsis 

minispropshow   [slotnumber/] asicpair   \    [--slot  slotnuiaber]  -all 

Availability 

all  users 

Description 

Use  this  command  to  display  the  ASIC  pair  properties. 


NOTE:  This  command  is  not  intended  for  normal  user  operation  and  is  available  to  provide  supplemental 
information  during  system  debug. 


Operands 

The  operands  are  as  follows: 

slotnumber /asicpair        Specifies  the  index  of  the  ASIC  pair  within  the  specified  blade  to 

be  displayed.  If  slotnumber  is  not  provided,  the  current  slot  is 
assumed. 

--slot  slotnumber  -all     Specifies  the  slot  on  which  to  operate.  The  default  is  0  and  and 

designed  to  operate  on  fixed-port-count  products. 

Examples 

To  display  all  index  1  ASIC  pair  properties: 

switch :user>  minispropshow  1  -all 

slot:   1,  minis :  0 
[2/16] 

<0, 1657/0001  1,1657/Q001> 

(be, 5)    (be, 4)    (be, 3)    (be, 2)    (be,l)    (be,0)    (bi,55)  (bi,54) 
(bi,25)    (bi,24)    (bi,41)    (bi,40)    (fe,3)    (fe,2)    (fe,l)  {fe,0) 

slot:    1,   minis :  1 
[2/16] 

<2, 1657/0001  3,1657/Q001> 

(be, 11)    (be, 10)    (be, 9)    (be, 8)  (be, 7)    (be, 6)    (bi,39)  (bi,38) 

(bi,9)    (bi,8)    (bi,57)    (bi,56)  (fe,7)    (fe,6)    (fe,5)  {fe,4) 

(continued  on  next  page) 
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o±(JL  .      -L  /      ILLJ-IiJ-O  . 

9 

z 

L  z  /  ±  0  J 

<4, 1657/0001  5, 

1657/0001> 

(be, 17)    (be, 16) 

(be, 15)    (be, 14) 

(be, 13) 

(be, 12) 

(bi,23) 

(bi, 22) 

iv^A    ii\     /V-,-;  in\ 

/"Kn    RQ\     /"Kt  c;q^ 

( re , 11 ) 

t  re ,  -L u ; 

( re , y ) 

I  re , 0 ) 

<6, 1657/0001  7, 

1657/0001> 

(be, 23)    (be, 22) 

(be, 21)    (be, 20) 

(be, 19) 

(be, 18) 

(bi,7) 

(bi, 6) 

(bi,27)  (bi,26) 

(bi,43)  (bi,42) 

(fe, 15) 

(fe, 14) 

(fe, 13) 

(fe, 12) 

See  also 

none 
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msCapabilityShow 


Displays  the  Management  Server  (MS)  capabilities. 

Synopsis 

ms  capabi 1 i  tyshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  supported  capabilities  of  the  Management  Server  for  each  switch  in  the 
fabric.  An  asterisk  displays  next  to  the  name  of  the  local  switch. 

"2^^  NOTE:    Reliable  commit  service  (RCS)  is  a  fabric-wide  capability  and  is  supported  only  if  all  the  switches 
in  the  fabric  support  RCS. 


Operands 

none 

Examples 

To  display  Management  Server  capability  on  a  fabric: 

switchl :user>  mscapabilityshow 

Switch  WWN  Capability  Name 


10:00:00:60:69:20:15:71  OxOOOOOOSf  "switchl"* 
10:00:00:60:69:00:30:05         OxOOOOOOSf  "switch2" 

Capability  Bit  Definitions: 
Bit  0 


Bit  1 
Bit  2 
Bit  3 
Bit  4 
Bit  5 
Bit  6 
Bit  7 
Bit  8 


Basic  Config  Service  Supported. 
Platform  Management  Service  Supported. 
Topology  Discovery  Service  Supported. 
Unzoned  Name  Service  Supported. 
Fabric  Zone  Service  Supported. 
Fabric  Lock  Service  Supported. 
Time  Service  Supported. 
RSCN  Small  Payload  Supported. 
Reliable  Commit  Service (RCS)  Supported. 


Others:  Reserved. 


Done . 
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See  also 

msConf igure 

ms  P iMgmt Ac  t  i va  t  e 

msPlMgmtDeactivate 

msTdDisable 

msTdEnable 

msTdReadConf ig 
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msConfigure 

Configures  the  Management  Server  (MS)  access  control  list  (ACL). 

Synopsis 

msconf igure 

Availability 

admin 

Description 

Use  this  command  to  configure  the  MS  ACL.  MS  allows  a  SAN  management  application  to  monitor  and 
administer  the  fabric  and  interconnect  elements,  such  as  switches.  This  application  is  located  at  the  Fibre 
Channel  well-known  address,  OxFFFFFA. 

If  the  MS  ACL  is  empty  (default),  MS  is  available  to  all  systems  connected  to  the  fabric.  By  populating  the 
MS  ACL  with  one  or  more  World  Wide  Names  (WWNs),  access  to  MS  is  restricted  to  those  WWNs  only. 

This  command  is  interactive  and  provides  the  user  with  the  following  menu  of  choices: 

1.  Done  (with  the  administration) 

2.  Display  the  ACL 

3.  Add  member  based  on  its  port/node  WWN 

4.  Delete  member  based  on  its  port/node  WWN 

If  the  MS  ACL  is  changed  by  adding  or  deleting  WWNs,  an  additional  prompt  is  given  asking  if  the  MS 
ACL  should  be  saved  to  nonvolatile  storage.  The  saved  MS  ACL  becomes  effective  upon  reboot. 

The  MS  ACL  is  implemented  on  a  per-switch  basis  and  should  be  configured  on  the  switch  to  which  the 
management  application  is  directly  connected. 

r2^^  NOTE:  When  security  is  enabled,  the  MS  ACL  is  not  used.  In  such  a  case,  access  to  MS  is  controlled  by 
li— I    security  by  way  of  the  MS_POLICY  configuration. 


Operands 

none 

Examples 

To  display  the  MS  ACL: 


switch 

admin>  msconfigure 

0 

Done 

1 

Display  the  access  list 

2 

Add  member  based  on  its  Port/Node  WWN 

3 

Delete  member  based  on  its  Port/Node  WWN 

select 

:    (0..3)    [1]  1 

(continued  on  next  page) 
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MS  Access  List 

consists  of    ( 5 ) :  { 

20:01: 

00:60: 

69  : 

GO  :  60 

:  10 

20  :  02  : 

00:60: 

69  : 

00:60 

:10 

20:03  : 

00:60: 

69  : 

00:60 

:10 

20 : 02  : 

00:60: 

69  : 

00  :  60 

:  03 

20:02: 

00:60: 

69  : 

00:60 

:  15 

0 

Done 

1 

Display  the 

access  list 

2 

Add 

member  based  on  its  Port/Node  WWN 

3 

Delete 

member  based  on  its  Port/Node  WWN 

select 

:  (0. 

.3) 

[1] 

0 

done  . 

See  also 

msCapabi 1 i  tyShow 

msPlatShow 

msPlClearDB 

ms  P IMgmt Ac  t  i va  t  e 

msPlMgmtDeactivate 

msTdDisable 

msTdEnable 

msTdReadConf ig 

secPolicyShow 
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msPlatShow 

Displays  the  Management  Server  (MS)  platform  database. 

Synopsis 

msplatshow 

Availability 

all  users 

Description 

Use  this  command  to  display  information  from  the  MS  platform  database.  This  command  displays  the 
name  of  each  platform  object  with  the  platform  type  (GATEWAY,  HOST_BUS_ADAPTER,  and  so  forth), 
associated  management  addresses,  and  associated  node  names. 

Operands 

none 

Examples 

To  display  the  MS  platform  database  for  a  fabric: 

switch : admin>  msplatshow 


Platform  Name:    [9]    "first  obj " 
Platform  Type:    5    :  GATEWAY 
Number  of  Associated  M.A. :  1 
Associated  Management  Addresses : 
[35]    "http: //Java. sun.com/products/plugin" 
Number  of  Associated  Node  Names:  1 
Associated  Node  Names : 
10:00:00:60:69:20:15:71 


Platform  Name:    [10]    "second  obj" 
Platform  Type:    7    :  HOST_BUS_ADAPTER 
Number  of  Associated  M.A. :  1 
Associated  Management  Addresses : 
[30 ]    "http : / / Java . sun . com/products/1 " 
Number  of  Associated  Node  Names:  2 
Associated  Node  Names : 

10:00:00:60:69:20:15:79 
10:00:00:60:69:20:15:75 
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See  also 

msCapabi 1 i  tyShow 

msConf igure 

msPlatShowDBCB 

msPlClearDB 

ms  P iMgmt Ac  t  i va  t  e 

msPlMgmtDeactivate 
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msPlatShowDBCB 

Displays  the  Management  Server  (MS)  platform  service  database  control  block. 

Synopsis 

msplatshowdbcb 

Availability 

all  users 

Description 

Use  this  command  to  display  the  control  block  fields  associated  v/ith  the  platform  database. 

Operands 

none 

Examples 

To  display  the  MS  platform  service  database  control  block: 

switch : admin>  msplatshowdbcb 

Domain      Worldwide  Name  Retry  Count     Exchange  Status 


3:    10:00:00:60:69:51:10:e6  0  0x2 


msPlDBCB.peerWwn  ==  00:00:00:00:00:00:00:00. 
msPlDBCB.psPeerWwn  ==  00:00:00:00:00:00:00:00. 
msPlDBCB . replicate  ==  0. 
msPlDBCB. fabMaySeg  ==  2  55. 
msPlDBCB. enabled  ==  1. 

See  also 

msCapabi 1 i  tyShow 
msConf igure 
msPlatShow 
msPlClearDB 
msPlMgmt Activate 
msPlMgmtDeactivate 
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msPlClearDB 


Clears  the  Management  Server  (MS)  platform  database  on  all  switches  in  the  fabric. 


Use  this  command  to  clear  the  MS  platform  database  on  all  switches  in  the  fabric.  Because  this  operation 
is  nonrecoverable,  it  should  not  be  used  unless  it  is  intended  to  resolve  a  database  conflict  between  two 
joining  fabrics  or  to  establish  an  entirely  new  fabric  with  an  empty  database. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

none 

Examples 

To  clear  the  MS  platform  database: 

switch :  adinin>  msplcleardb 


MS  Platform  Service  is  currently  enabled. 

This  will  erase  MS  Platform  Service  Database  in  the  entire  fabric. 
Would  you  like  to  continue  this  operation?    (yes,  y,   no,   n) :    [no]  y 

Request  to  MS  Platform  DB  Clear  operation  in  progress  

*Completed  clearing  MS  Platform  Service  Database!! 


msCapabi 1 i  tyShow 
msConf igure 
msPlatShow 
msPlatShowDBCB 
ms  P iMgmt Ac  t  i va  t  e 
msPlMgmtDeactivate 


Synopsis 


msplcleardb 


Availability 


admin 


Description 


See  also 
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msPlMgmtActivate 


Activates  the  Management  Server  (MS)  platform  service. 


Synopsis 


msplmgmtactivate 


Availability 


admin 


Description 


Use  this  command  to  activate  the  MS  platform  service  in  the  entire  fabric.  This  command  attempts  to 
activate  the  MS  platform  service  for  each  sv/itch  in  the  fabric.  If  successful,  the  change  takes  effect 
immediately  and  commits  to  the  change  to  nonvolatile  storage  of  each  sv/itch.  After  successful  activation, 
all  sv/itches  in  the  fabric  boot  with  the  MS  platform  service  enabled. 

By  default,  the  MS  platform  service  is  disabled. 

Before  issuing,  run  the  msCapabilityShow  command  to  verify  all  switches  in  the  fabric  support  MS 
platform  service;  otherwise,  the  command  fails. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 


none 


Examples 


To  activate  the  MS  platform  service: 


switch : admin>  msplmgmtactivate 


Request  to  activate  MS  Platform  Service  in  progress 


*Completed  activating  MS  Platform  Service  in  the  fabric! 


See  also 


msCapabi 1 i  tyShow 


msPlatShow 


msPlClearDB 


msPlMgmtDeactivate 
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msPlMgmtDeactivate 

Deactivates  the  Management  Server  (MS)  platform  service. 

Synopsis 

msplmgmtdeactivate 

Availability 

admin 

Description 

Use  this  command  to  deactivate  the  MS  platform  service  in  the  entire  fabric.  This  command  deactivates  the 
MS  platform  service  for  each  switch  in  the  fabric  and  commits  the  change  to  nonvolatile  storage.  After  a 
successful  deactivation,  all  sv/itches  in  the  fabric  boot  v/ith  the  MS  platform  service  disabled. 

NOTE:   When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  sv/itch. 
Operands 

none 

Examples 

To  deactivate  the  MS  platform  service  on  all  sv/itches  in  the  fabric: 


switch :  adinin>  msplmgmtdeactivate 

MS  Platform  Service  is  currently  enabled. 

This  will  erase  MS  Platform  Service  configuration 
information  as  well  as  database  in  the  entire  fabric. 

Would  you  like  to  continue  this  operation?    (yes,  y,   no,   n) : 

[no]  y 

Request  to  deactivate  MS  Platform  Service  in  progress  

*Completed  deactivating  MS  Platform  Service  in  the  fabric! 

See  also 

msCapabi 1 i  tyShow 

msConf igure 

msPlatShow 

msPlatShowDBCB 

msPlClearDB 

ms  P iMgmt Ac  t  i va  t  e 
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msTdDisable 

Disables  the  Management  Server  (MS)  topology  discovery  service. 

Synopsis 

mstddisable  ["all"] 

Availability 

admin 

Description 

Use  this  command  to  disable  the  management  server  topology  discovery  service  of  a  local  sv/itch  or  an 
entire  fabric.  This  change  takes  effect  immediately  and  commits  to  the  configuration  database  for  all 
sv/itches;  therefore,  persistent  across  pov/er  cycles  and  reboots. 

If  the  "all"  operand  is  used,  this  command  attempts  to  disable  the  topology  discovery  service  on  all 
sv/itches  in  the  fabric. 


NOTE:  When  security  is  enabled,  and  using  the  "all"  operand,  this  command  can  be  issued  only  from 
the  primary  FCS  sv/itch. 


Operands 

This  command  has  the  follov/ing  operand: 

"all"  Disables  the  MS  topology  discovery  service  throughout  the  entire 

fabric.  This  operand  is  optional. 

Examples 

To  disable  the  MS  topology  discovery  service  on  the  local  switch  only: 


switch :  ac3inin>  mstddisable 

This  may  erase  all  NID  entries.     Are  you 

sure?  (yes, 

y,   no,   n) : 

[no]  y 

Request  to  disable  MS  Topology  Discovery 

Service  in 

progress . . . 

done . 

*MS  Topology  Discovery  disabled  locally. 

To  disable  MS  topology  discovery  on  all  the  switches  in 

the  fabric: 

switch : admin>  mstddisable  "ALL" 

This  may  erase  all  NID  entries.     Are  you 

sure?  (yes, 

y,   no,   n) : 

[no]  y 

Request  to  disable  MS  Topology  Discovery 

Service  in 

progress .  .  . 

done . 

*MS  Topology  Discovery  disabled  locally. 

*MS  Topology  Discovery  Disable  Operation 

Complete ! ! 
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See  also 

msTdEnable 
msTdReadConf ig 
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msTdEnable 

Enables  the  Management  Server  (MS)  topology  discovery  service. 

Synopsis 

mstdenable  ["all"] 

Availability 

admin 


Description 

Use  this  command  to  enable  the  MS  topology  discovery  service  on  a  local  sv/itch  or  on  the  entire  fabric. 
This  change  takes  effect  immediately  and  commits  to  the  configuration  database  for  all  affected  switches. 

If  the  operand  "all"  is  used,  this  command  attempts  to  enable  the  MS  topology  discovery  service  on  all 
sv/itches  in  the  fabric. 


NOTE:  When  security  is  enabled,  and  using  the  "all"  operand,  this  command  can  be  issued  only  from 
the  primary  PCS  sv/itch. 


Operands 

This  command  has  the  following  operand: 

"all"  Enables  the  MS  topology  discovery  service  throughout  the  entire 

fabric.  This  operand  is  optional.. 

Examples 

To  enable  the  MS  topology  discovery  service  on  the  local  switch  only: 


switch: admin>  mstdenable 

Request  to  enable  MS  Topology  Discovery 

Service  in  progress. . . . 

done . 

*MS  Topology  Discovery  enabled  locally. 

To  enable  MS  topology  discovery  on  all  the  switches  in 

the  fabric: 

switch : admin>  mstdenable  "ALL" 

Request  to  enable  MS  Topology  Discovery 

Service  in  progress. . . . 

done . 

*MS  Topology  Discovery  enabled  locally. 

*MS  Topology  Discovery  Enable  Operation 

Complete ! ! 

See  also 

msTdDisable 
msTdReadConf ig 
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msTdReadConfig 


Displays  the  status  of  Management  Server  (MS)  topology  discovery  service. 

Synopsis 

mstdreadconf ig 

Availability 

all  users 

Description 

Use  this  command  to  check  whether  or  not  the  management  server  topology  discovery  service  is  enabled. 

Operands 

none 

Examples 

To  display  the  status  of  the  topology  discovery  service: 

switch  :adinin>  mstdreadconf  ig 

*MS  Topology  Discovery  is  enabled. 

See  also 

msCapabi 1 i  tyShow 

msConf igure 

ms  P iMgmt Ac  t  i va  t  e 

msPlMgmtDeactivate 

msTdDisable 

msTdEnable 
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myld 

Displays  the  current  login  session  details. 

Synopsis 

myid 

Availability 

admin 

Description 

Use  this  command  to  display  the  status  of  the  system  and  the  login  session  details. 
The  login  session  gives  details  of  the  following: 

•  CP/switch  (or  console/serial  port)  used  to  log  in 

•  The  IP  address  of  the  current  login  session  for  telnet  or  the  name  of  the  current  console  port  or  the  serial 
port  (if  modem  login  used) 

•  The  current  CP's  mode  (Active,  Standby,  or  Unknov/n) 

•  The  current  system  status  (Redundant,  Non-Redundant,  or  Unknown). 

Operands 

none 

Examples 

To  display  current  login  information: 


switch : admin>  myid 

Current  Switch: 

switch 

Session  Detail: 

switch   (12  3.123.123.123)  Active  Redundant 

See  also 

version 


336   Fabric  OS  commands 


nbrStateShow 

Displays  FSPF  neighbor's  state. 

Synopsis 

nbrstateshow   [slotnumber/]  [portnumber] 

Availability 

all  users 

Description 

Use  this  command  to  display  information  about  neighbors  to  the  local  switch,  or  information  about  a 
specific  neighbor  if  a  port  number  is  supplied.  FSPF  defines  a  neighbor  as  a  remote  E_Port  interface  that  is 
directly  attached  to  the  local  switch.  The  following  fields  display: 

Local  Domain  ID  Domain  number  of  local  switch. 

Local  Port  E_Port  (interface)  on  local  switch. 

Domain  Domain  number  of  remote  switch. 

Remote  Port  E_Port  (interface)  on  remote  switch. 

State  State  of  the  neighbor.  The  E_Port  is  used  to  route  frames 

only  if  the  neighbor  is  in  NB_ST_FULL  state. 

Operands 

This  command  has  the  following  operands: 

slotnumber       Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director  2/1  28. 

For  all  other  switches,  this  operand  is  not  required.  The  slot  number  must 
be  followed  by  a  slash  (  /  )  and  the  port  number,  so  that  each  port  is 
represented  by  both  slot  number  (1  through  4  or  7 
through  10)  and  port  number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of  1 0  slots. 
Slot  numbers  5  and  6  are  control  processor  cards;  slots  1  through  4  and 
7  through  1 0  are  port  cards.  On  each  port  card,  there  are  1 6  ports, 
counted  from  the  bottom,  numbered  0  to  15. 

portnumber       Specify  a  port  number.  Valid  values  for  port  number  vary,  depending  on 
the  switch  type.  This  operand  is  optional. 

Examples 

To  display  information  about  switches  directly  connected  to  the  local  switch: 


switch:user> 

nbrstateshow 

2/0 

Local  Domain 

ID:  1 

Local  Port 

Domain 

Remote  Port 

State 

16 

2 

48 

NB_ST_FULL 

See  also 

interf aceShow 
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nbrStatsClear 


Resets  FSPF  interface  counters. 

Synopsis 

nbrstatsclear    [slotnumber/]  [portnumber] 

Availability 

admin 

Description 

Use  this  command  to  reset  the  counters  of  FSPF  frames  transmitted  and  received  on  each  inter-switch  link 
(ISL)  or  a  specific  ISL.  These  counters  display  using  the  using  the  interf  aceShow  command. 

Use  this  command  without  operands  to  reset  counters  on  all  interfaces. 

Operands 

This  command  has  the  following  operands: 

slotnumber       Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director  2/1  28. 

For  all  other  switches,  this  operand  is  not  required.  The  slot  number  must 
be  followed  by  a  slash  (  /  )  and  the  port  number,  so  that  each  port  is 
represented  by  both  slot  number  (1  through  4  or  7  through  10)  and  port 
number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of  1 0  slots. 
Slot  numbers  5  and  6  are  control  processor  cards;  slots  1  through  4  and 
7  through  1 0  are  port  cards.  On  each  port  card,  there  are  1 6  ports, 
counted  from  the  bottom,  numbered  0  to  15. 

portnumber       Specify  a  port  number.  Valid  values  for  port  number  vary,  depending  on 
the  switch  type.  This  operand  is  optional. 

When  this  command  is  specified  with  no  operand,  the  statistics  are  cleared  for  all  interfaces. 

Examples 

To  reset  the  counters  on  a  port: 

switch : admin>  interf aceshow  1/0 

idbP  =  0xl0050a38 

Interface  0  data  structure: 

nghbP  =  0xl004ce68 

if No  =  0 

masterPort  =  0  (self) 

defaultCost  =  500 

cost  =  500 

delay  =  1 

(continued  on  next  page) 


338   Fabric  OS  commands 


(output  truncated) 

nCmdAcc 

= 

O  1 

nInvCmd 

= 

n 
u 

nHloIn 

= 

1  n 

nlnvHlo 

= 

u 

nLsuIn 

= 

1  n 

nLsaIn 

= 

1  n 

attHloOut 

= 

1  1 
±  J. 

nHloOut 

= 

1  1 

±  J. 

attLsuOut 

nLsuOut 

12 

attLsaOut 

17 

nLsaOut 

17 

switch :  adinin> 

nbrstatsclear 

1/0 

switch : admin> 

interf aceshow 

1/0 

idbP 

0xl0050a3e 

i 

Interface  0  data  structure: 

nghbP 

0xl004ce6e 

> 

if  No 

0 

masterPort 

0  (self) 

def aultCost 

500 

cost 

500 

(output  truncated) 

nCmdAcc 

0 

nInvCmd 

0 

nHloIn 

0 

nlnvHlo 

0 

nLsuIn 

0 

nLsaIn 

0 

attHloOut 

0 

nHloOut 

0 

attLsuOut 

0 

nLsuOut 

0 

attLsaOut 

0 

nLsaOut 

0 
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See  also 

interf aceShow 

portShow 

switchShow 
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nodeFind 

Displays  all  the  device  Name  Server  (NS)  entries  matching  a  given  WWN, device  PID,  or  alias. 

Synopsis 

nodef  ind  WVm  \    PID   \  ALIAS 

Availability 

all  users 

Description 

Use  this  command  to  display  the  NS  information  for  all  the  devices  in  the  fabric  that  have  either  a  port 
World  Wide  Name  (WWN)  or  a  node  WWN  matching  v/ith  the  given  WWN;  or  have  a  device  PID 
matching  with  the  given  PID;  or  have  a  defined  configuration  alias  to  v/hich  the  device  belongs  matching 
v/ith  the  given  alias. 

The  message  No  device  is  found  displays  if  there  is  no  device  matching  the  given  WWN,  PID,  or 
alias. 

Operands 

This  command  has  the  following  operand: 

WWN  I  PID  I  ALIAS     Specify  the  WWN,  device  PID,  or  alias  that  can  be  used  to  match 

the  real  device's  data.  WWN  must  have  eight  colon-separated 
fields,  each  consisting  of  one  or  two  hexadecimal  digits  between  0 
and  ff,  with  no  spaces.  PID  must  begin  with  Ox  or  OX;  otherwise,  it 
interprets  as  an  alias. 

Examples 

To  display  all  the  device  information  matching  the  given  data: 


switch :  adinin>  nodef  ind  a32  0 

Local : 

Type  Pid        COS  PortName 

NodeName 

SCR 

NL       0314d9;               3 ; 22 : 00 : 00 : 04 : cf : 

5d:dc:2d;20:00:00 

04 

cf 

5d 

do 

2d;  0 

FC4s:    FCP    [SEAGATE  ST318452FC 

0001] 

Fabric  Port  Name:  20:14:00:60:69 

:80:04:79 

Device  type:   Physical  Target 

Aliases:  a320 

NL        0314d6;               3 ; 22  :  GO : 00 : 04 : cf : 

9f :78:7b;20:00:00 

04 

cf 

9f 

78 

7b;  0 

FC4s:    FCP    [SEAGATE  ST33  6605FC 

0003] 

Fabric  Port  Name:  20:14:00:60:69 

:80:04:79 

Device  type:   Physical  Target 

Aliases:  a320 

(continued  on  next  page) 
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Fabric  Port  Name:  20:14:00:60:69:80:04:79 

Device  type :   Physical  Target 

Aliases:  a320 

To  display  all  the  device  information  matching  the  given  WWN: 


switch: admin>  nodefind  20:00:00:e0: 

8b: 

01 ; 

:  ce  : 

d3 

Remote : 

Type  Pid        COS  PortName 

NodeName 

NL       020eef;              3 ; 20 : 00 : 00 : eO 

:8b 

:  01 

:  ce 

:d3;20:00:00:e0:8b:01:ce:d3; 

Fabric  Port  Name:  20:0e:0Q: 

60: 

69  ; 

:51: 

Ob:ba 

Device  type:   Physical  Target 

Aliases : 

To  display  all  the  device  information  matching  the  given  PID: 


switch : admin>  nodefind  0x02 Oeef 

Remote : 

Type  Pid        COS  PortName 

NodeName 

NL       020eef;              3 ; 20 : 00 : 00 : eO 

:8b: 

:  01 

:ce:d3;20:00:00:e0:8b:01:ce:d3; 

Fabric  Port  Name:  20:0e:00: 

60: 

69  : 

51:0b:ba 

Device  type:   Physical  Target 

Aliases : 

To  display  all  the  device  information  matching  the  given  no  match: 


switch : admin>  nodefind  abed 
No  device  found. 

See  also 

aliShow 
nsAllShow 
nscamShow 
nsShow 
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nsAliasShow 


Displays  local  Name  Server  (NS)  information,  with  aliases. 

Synopsis 

nsaliasshow   [ -r  -t] 

Availability 

all  users 

Description 

Use  this  command  to  display  local  name  server  information  v/ith  the  added  feature  of  displaying  the 
defined  configuration  aliases  to  v/hich  the  device  belongs. 

The  follov/ing  message  is  displayed  if  there  is  no  information  in  this  switch: 

There  is  no  entry  in  the  Local  Name  Server 
The  command  nsAllShow  displays  information  from  all  switches. 

The  display  resulting  from  this  command  is  identical  to  the  command  nsAllShow,  with  the  exception  of 
an  additional  line  listing  to  which  the  aliases  the  device  belongs.  If  there  are  no  defined  configuration 
aliases  for  that  device,  no  alias  is  displayed. 

Operands 

This  command  has  the  following  operands: 

-r  Replaces  the  time-to-live  (TTL)  attribute  output  with  state  change  registration 

(SCR)  information  in  the  display.  This  value  indicates  what  type  of 
registered  state  change  notification  (RSCN)  a  device  registers  to  receive. 
Values  include: 

SCR=0  Reserved. 

SCR=1  Fabric  detected  registration.  Register  to  receive  all 

RSCN  requests  issued  by  the  fabric  controller  for 
events  detected  by  the  fabric. 

SCR=2  Nx_Port  detected  registration.  Register  to  receive  all 

RSCN  requests  issued  for  events  detected  by  the 
affected  Nx_Port. 

SCR=3  Register  to  receive  all  RSCN  request  issued.  The 

RSCN  request  returns  all  effected  N_Port_ID  pages. 

-t  Displays  the  device  type.  Of  the  two  device  type  parts,  the  first  part 

indicates  the  origination  of  the  device.  Currently,  four  originations  are 
defined: 

Physical  Device  connected  to  the  Nx_Port,  using  FLOG!  to 

login  to  the  switch 

Virtual  Contrived  device  by  the  switch 

NPV  Device  connected  to  the  Nx_Port,  using  FDISC  to  log 

in  to  the  switc 

iSCSI  Device  connected  to  the  iSCSI  port 

The  second  part  indicates  the  role  of  the  device.  Currently,  four  roles  are 
defined: 

Unknown  Device  role  is  not  detected 

(initiator/target) 
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Initiator  A  SCSI  initiator 

Target  A  SCSI  target 

Initiator+Target         Both  a  SCSI  initiator  and  a  SCSI  target 


Examples 

To  display  local  NS  information  with  aliases: 


switch : admin>  nsAliasShow 
{ 

Type  Pid        COS  PortName  NodeName  TTL(sec) 

N         021200;  2 , 3 ; 10  :  00  :  00  :  60 : 69  :  00  :  03  : 19 ; 30  :  00  :  00  :  60  :  69  :  00  :  03  : 19  ;  na 

FC4s:  FCIP 

Fabric   Port  Name:  20:02:00:60:69:01:44:22 
Aliases : 

N         021300;  3  ;  10  :  00  :  00  :  60  :  69 : 00 : 02 : d6 ; 2 0 : 00 : 00 : 60 : 69 : 00  :  02  :  d6  ;  na 

Fabric  Port  Name:  20:03:00:60:69:01:44:22 

Aliases:  DeviceAlias 
NL        0214e2;  3 ; 2 1 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : le ; 2 0 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : le ;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  MT09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Aliases : 

NL        0214e4;  3 ; 2 1 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : el ; 2 0 : 00 : 0 0 : f a : ce : 0 0 : 2 1 : el ;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  CD09] 

Fabric   Port  Name:  20:04:00:60:69:01:44:22 

Aliases:  MyAliasl  MYAlias2 
NL        0214e8;  3 ; 2 1 : 00 : 00 : f a : ce : 04 : 83 : c9 ; 2 0 : 00 : 00 : f a : ce : 04 : 83 : c9 ;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  NS09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Aliases : 

NL       0214ef;  3;21:00:00:ad:bc:04:6f :70;20:00:00:ad:bc:04:6f :70;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  JB09] 
Fabric   Port  Name:  20:04:00:60:69:01:44:22 
Aliases : 

The  Local  Name  Server  has  6  entries  } 
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To  display  local  NS  information  with  aliases  with  -r  option: 


switch : adinin>  nsAliasShow  -r 
{ 

Type  Pid        COS  PortName  NodeName  SCR 

N         021200;  2 , 3  ;  10  :  00 : 00  :  60 : 69 : 00 : 03 : 19 ; 30 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ;  3 

FC4s:  FCIP 

Fabric  Port  Name:  20:02:00:60:69:01:44:22 
Aliases : 

N         021300;  3 ; 10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ; 2 0 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ;  1 

Fabric  Port  Name:  20:03:00:60:69:01:44:22 

Aliases:  DeviceAlias 
NL       0214e2;  3 ; 2 1 : 0 0 : 00 : f a : ce : 0 0 : 2 1 : le ; 2 0 : 00 : 0 0 : f a : ce : 0 0 : 2 1 : le ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  MT09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Aliases : 

NL       0214e4;  3 ; 2 1 : 0 0 : 00 : f a : ce : 0 0 : 2 1 : el ; 2 0 : 00 : 0 0 : f a : ce : 0 0 : 2 1 : el ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  CD09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Aliases:  MyAliasl  MYAlias2 
NL       0214e8;  3 ; 2 1 : 0 0 : 00 : f a : ce : 04 : 83 : c9 ; 2 0 : 00 : 0 0 : f a : ce : 04 : 83 : c9 ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  NS09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Aliases : 

NL       0214ef;  3 ; 2 1 : 0 0 : 00 : ad : bc : 04 : 6 f : 7 0 ; 2 0 : 00 : 0 0 : ad : bc : 04 : 6 f : 7 0 ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  JB09] 
Fabric  Port  Name:  20:04:00:60:69:01:44:22 
Aliases : 

The  Local  Name  Server  has  6  entries  } 
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To  display  local  NS  information  with  aliases  with  -rand  -t  options: 


switch : admin>  nsAliasShow  -r  -t 
{ 

Type  Pid        COS  PortName  NodeName  SCR 

N         021200;  2 , 3 ; 10 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ; 30 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ;  3 

FC4s:  FCIP 

Fabric   Port  Name:  20:02:00:60:69:01:44:22 
Device  type:   Physical  Unknown ( initiator /target ) 
Aliases : 

N         021300;  3 ; 10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ; 20 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ;  1 

Fabric   Port  Name:  20:03:00:60:69:01:44:22 

Device  type:  NPV  Initiator 

Aliases:  DeviceAlias 
NL        0214e2;  3 ; 2 1 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : le ; 2 0 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : le ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  MT09] 

Fabric   Port  Name:  20:04:00:60:69:01:44:22 

Device  type:  Physical  Target 

Aliases : 

NL        0214e4;  3 ; 2 1 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : el ; 2 0 : 00 : 0 0 : f a : ce : 0 0 : 2 1 : el ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  CD09] 

Fabric   Port  Name:  20:04:00:60:69:01:44:22 

Device  type:   Physical  Target 

Aliases:  MyAliasl  MyAlias2 
NL       0214e8;  3 ; 2 1 : 00 : 00 : f a : ce : 04 : 83 : c9 ; 2 0 : 00 : 00 : f a : ce : 04 : 83 : c9 ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  NS09] 

Fabric   Port  Name:  20:04:00:60:69:01:44:22 

Device  type:   Physical  Target 

Aliases : 

NL        0214ef;  3;21:00:00:ad:bc:04:6f :70;20:00:00:ad:bc:04:6f :70;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  JB09] 
Fabric   Port  Name:  20:04:00:60:69:01:44:22 
Device  type:   Physical  Target 
Aliases : 

The  Local  Name  Server  has  6  entries  } 


See  also 

nsAllShow 

nsShow 

switchShow 
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nsAllShow 

Displays  global  name  server  information. 

Synopsis 

nsallshow  [type] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  24-bit  Fibre  Channel  addresses  of  all  devices  in  all  sv/itches  in  the  fabric. 
If  the  type  operand  is  supplied,  only  devices  of  specified  FC-PH  type  are  displayed.  If  type  is  omitted,  all 
devices  are  displayed. 

'2^^  NOTE:    Specifying  the  type  operand  causes  the  sv/itch  to  send  out  a  query  to  every  sv/itch  in  the  fabric. 
On  a  large  fabric  you  should  not  run  a  script  that  repeatedly  issues  the  nsAllShow  command  vvith  a 
type  operand  specified. 


Operands 

This  command  has  the  following  operand: 

type  Specify  the  FC-PH  type  code.  This  operand  is  optional.  The  valid  values 

for  this  operand  are  0  to  255.  Follov/ing  are  two  specific  FC-PH  device 
type  codes: 

8  =  FCP  type  device 

4,5  =  FC-IP  type  device 

Other  FC-PH  types  are  displayed  in  the  format  x  ports  supporting 
FC4  code,  where  x  is  the  number  of  ports  of  a  type  and  code  is  the 
FC-PH  type  code. 

Examples 

To  display  all  devices  in  the  fabric,  followed  by  all  type  8  (SCSI-FCP)  devices  and  all  type  5  (SCSI-FCIP) 
devices: 

switch : admin>  nsallshow 

12  Nx_Ports  in  the  Fabric  { 

011200  0118e2  0118e4  0118e8  OllSef  021200 

0214e2  0214e4  0214e8  0214ef 

} 

switch :ad[nin>  nsallshow  8 
8  FCP  Ports  { 

0118e2  0118e4  0118e8  0118ef  0214e2  0214e4  0214e8  0214ef 
} 

switch : admin>  nsallshow  5 

2  FC-IP  Ports  in  the  Fabric  { 
011200  021200} 
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See  also 

nsShow 
switchShow 
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nscamShow 

Displays  information  about  remote  devices  in  the  Name  Server  (NS)  cache. 

Synopsis 

nscamshow  [-t] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  local  NS  cache  information  about  the  devices  discovered  in  the  fabric  by 
the  NS  cache  manager. 

The  message  No  Entry  found!  displays  if  the  NS  cache  manager  does  not  discover  new  switches  or 
new  devices  in  the  fabric. 

For  each  remote  switch  found,  the  output  of  this  command  displays  the  domain  number,  state,  revision, 
owner,  and  a  list  of  devices  for  that  domain  number.  For  each  device  found  in  the  devices  list,  the 
following  information  is  displayed: 

Type  U  for  unknown,  N  for  N_Port,  NL  for  NL_Port 

Pid  The  24-bit  Fibre  Channel  address 

COS  A  list  of  classes  of  service  supported  by  the  device 

PortName  The  device's  port  World  Wide  Name 

NodeName  The  device's  node  World  Wide  Name 

There  might  be  additional  lines  if  the  device  has  registered  FC4s  supported  and  fabric  port  name. 

Operands 

The  operand  is  as  follows: 

-t  Specify  to  display  the  device  type.  Of  the  two  device  type  parts,  the  first 

part  indicates  the  origination  of  the  device.  Currently,  four  originations 
are  defined: 

Physical  Device  connected  to  the  Nx_Port,  using  FLOGI  to 

login  to  the  switch 

Virtual  Contrived  device  by  the  switch 

NPV  Device  connected  to  the  Nx_Port,  using  FDISC  to  log 

in  to  the  switch 

iSCSI  Device  connected  to  the  iSCSI  port 

The  second  part  indicates  the  role  of  the  device.  Currently,  four  roles  are 
defined: 

Unknown  Device  role  is  not  detected 
(initiator/target) 

Initiator  A  SCSI  initiator 

Target  A  SCSI  target 

Initiator+Target  Both  a  SCSI  initiator  and  a  SCSI  target 
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Examples 

To  display  all  switch  and  device  entries  discovered  by  the  NS  in  the  fabric: 


switch : admin>  nscamShow 

nscam  show  for  remote  switches: 

Switch  entry  for  2 

state      rev  owner 

known        v43  0  OxfffcOl 

Device  list:  count  1 

Type  Pid        COS  PortName 

NodeName 

N  021200; 

2, 3; 10:00:00:60:69:00: ab:ba; 10:00:00:60:69:00: ab: 

:ba; 

FC4s:  FCIP 

Fabric  Port  Name:  20:02:00:60:69:00:6 

8:19 

Switch  entry  for  4 

state     rev  owner 

known      v32  0  OxfffcOl 

Device  list:   count  0 

No  entry  is  found! 

To  display  the  output  v/ith  -t  option: 


switch : admin>  nscamShow  -t 

nscam  show  for  remote  switches: 

Switch  entry  for  2 

state      rev  owner 

known        v43  0  OxfffcOl 

Device  list:  count  1 

Type  Pid        COS  PortName 

NodeName 

N  021200; 
2,3;10:00:00:60:69:00:ab:ba;10:00:00:60:69: 

00  ; 

:ab: 

:ba; 

FC4s:  FCIP 

Fabric  Port  Name:  20:02:00: 

60  : 

:69; 

;00:68:19 

Device  type:   Physical  Initiator 

Switch  entry  for  4 

state    rev  owner 

known      v32  0  OxfffcOl 

Device  list:   count  0 

No  entry  is  found! 

See  also 

nsAllShow 

nsShow 

switchShow 
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nsShow 

Displays  local  Name  Server  (NS)  information. 

Synopsis 

nsshow   [-r  -t] 

Availability 

all  users 

Description 

Use  this  command  to  display  local  NS  information  about  devices  connected  to  this  sv/itch. 
The  following  message  is  displayed  if  there  is  no  information  in  this  sv/itch: 

There  is  no  entry  in  the  Local  Name  Server 

There  still  might  be  devices  connected  to  other  sv/itches  in  the  fabric.  The  nsAllShow  command  displays 
information  from  all  sv/itches.  Each  line  of  output  displays: 


* 

Indicates  a  cached  entry  from  another  sv/itch. 

Type 

U  for  unknov/n,  N  for  N_Port,  NL  for  NL_Port. 

PID 

24-bit  Fibre  Channel  address. 

COS 

List  of  classes  of  service  supported  by  device. 

PortName 

Device  port  World  Wide  Name. 

NodeName 

Device  node  World  Wide  Name. 

TTL 

Time-to-live  (in  seconds)  for  cached  entries  or  NA  (not 

applicable)  if  the  entry  is  local. 

SCR 

State  change  registration  of  the  device.  This  displays  if  the 

option  is  given. 

There  might  be  additional  lines  if  the  device  has  registered  any  of  the  follov/ing  information  (the  sv/itch 
automatically  registers  SCSI  inquiry  data  for  FCP  target  devices): 

•  FC4s  supported 

•  IP  address 

•  IPA 

•  Port  and  node  symbolic  names 

•  Fabric  Port  Name.  This  is  the  WWN  of  the  port  on  the  switch  to  which  the  device  is  physically 
connected. 

•  Hard  address  and/or  port  IP  address 

Operands 

This  command  has  the  following  operands: 

-r  Replaces  the  TTL  attribute  output  with  SCR  (state  change  registration) 

information  in  the  display.  This  value  indicates  what  type  of  RSCN  a  device 
registers  to  receive.  Values  include: 

SCR=0  Reserved. 


Fabric  OS  5.0.0  command  reference  guide  351 


SCR=1  Fabric  detected  registration.  Register  to  receive  all 

RSCN  requests  issued  by  the  fabric  controller  for 
events  detected  by  the  fabric. 

SCR=2  Nx  Port  detected  registration.  Register  to  receive  all 

RSCN  requests  issued  for  events  detected  by  the 
affected  Nx_Port. 

SCR=3  Register  to  receive  all  RSCN  request  issued.  The  RSCN 

request  returns  all  effected  N_Port_ID  pages. 

Displays  the  device  type.  Of  the  tv/o  device  type  parts,  the  first  part 
indicates  the  origination  of  the  device.  Currently,  four  originations  are 
defined: 

Physical  Device  connected  to  the  Nx_Port,  using  FLOG!  to  login 

to  the  switch 

Virtual  Contrived  device  by  the  switch 

NPV  Device  connected  to  the  Nx  Port,  using  FDISC  to  log  in 

to  the  switch 

iSCSI  Device  connected  to  the  iSCSI  port 

The  second  part  indicates  the  role  of  the  device.  Currently,  four  roles  are 
defined: 

Unknown  Device  role  is  not  detected 
(initiator/target) 

Initiator  A  SCSI  initiator 

Target  A  SCSI  target 

Initiator+Target  Both  a  SCSI  initiator  and  a  SCSI  target 


Examples 


To  display  local  NS  information: 


switch : admin>  nsShow 
{ 

Type  Pid        COS  PortName  NodeName  TTL(sec) 

N         021200;  2 , 3 ; 10 : GO : GO : 60 : 69 : GO : 03 : 19 ; 30 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ;  na 

FC4s:  FCIP 

Fabric  Port  Name:  20:02:00:60:69:01:44:22 
N         021300;  3 ; 10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ; 2 0 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ;  na 

Fabric  Port  Name:  20:03:00:60:69:01:44:22 
NL       0214e2;  3 ; 21 : 00 : 00 : f a : ce : 00 : 2 1 : le ; 2 0 : 00 : 00 : f a : ce : 00 : 2 1 : le ;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  MT09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 
NL       0214e4;  3 ; 21 : 00 : 00 : f a : ce : 00 : 2 1 : el ; 2 0 : 00 : 00 : f a : ce : 00 : 2 1 : el ;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  CD09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 
NL       0214e8;  3 ; 21 : 00 : 00 : f a : ce : 04 : 83 : c9 ; 2 0 : 00 : 00 : f a : ce : 04 : 83 : c9 ;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  NS09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 
NL       0214ef;  3 ; 21 : 00 : 00 : ad : be : 04 : 6f : 70 ; 2 0 : 00 : 00 : ad : be : 04 : 6f : 70 ;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  JB09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

The  Local  Name  Server  has  6  entries  } 
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To  display  local  NS  information  with  -r: 


switch : admin>  nsShow  -r 
{ 

Type  Pid        COS  PortName  NodeName  SCR 

N         021200;  2 , 3 ; 10 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ; 3 0 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ;  3 

FC4s:  FCIP 

Fabric  Port  Name:  20:02:00:60:69:01:44:22 
N         021300;  3 ; 10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ; 2 0 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ;  1 

Fabric  Port  Name:  20:03:00:60:69:01:44:22 
NL       0214e2;  3 ; 2 1 : 00 : 00 : f a : ce : 00 : 2 1 : le ; 2 0 : 00 : 00 : f a : ce : 00 : 21 : le ;  0 

FC4s:   FCP    [STOREX     RS2999FCPH3  MT09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 
NL       0214e4;  3 ; 2 1 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : el ; 2 0 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : el ;  0 

FC4s:   FCP    [STOREX     RS2999FCPH3  CD09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 
NL       0214e8;  3 ; 2 1 : 00 : 00 : f a : ce : 04 : 83 : c9 ; 2 0 : 00 : 00 : f a : ce : 04 : 83 : c9 ;  0 

FC4s:   FCP    [STOREX     RS2999FCPH3  NS09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 
NL       0214ef;  3 ; 2 1 : 00 : 00 : ad : be : 04 : 6f : 70 ; 2 0 : 00 : 00 : ad : be : 04 : 6f : 7 0 ;  0 

FC4s:   FCP    [STOREX     RS2999FCPH3  JB09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

The  Local  Name  Server  has  6  entries  } 


To  display  local  NS  information  with  -r  and  -t: 


sw5 : admin>  nsShow  -r  -t 
{ 

Type  Pid        COS  PortName  NodeName  SCR 

N         021200;  2 , 3 ; 10 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ; 3 0 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ;  3 

FC4s:  FCIP 

Fabric  Port  Name:  20:02:00:60:69:01:44:22 

Device  type:   Physical  Unknown ( initiator /target ) 
N         021300;  3 ; 10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ; 2 0 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ;  1 

Fabric  Port  Name:  20:03:00:60:69:01:44:22 

Device  type:  NPV  Initiator 
NL       0214e2;  3 ; 21 : 00 : 00 : f a : ce : 00 : 2 1 : le ; 2 0 : 00 : 00 : f a : ce : 00 : 21 : le ;  0 

FC4s:   FCP    [STOREX     RS2999FCPH3  MT09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Device  type:   Physical  Target 
NL       0214e4;  3 ; 2 1 : 00 : 00 : f a : ce : 00 : 2 1 : el ; 2 0 : 00 : 00 : f a : ce : 00 : 21 : el ;  0 

FC4s:   FCP    [STOREX     RS2999FCPH3  CD09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Device  type:   Physical  Target 

(continued  on  next  page) 
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NL       0214e8;              3 ; 21 : 00 : 00 : f a : ce : 

04:83:c9;20: 

:  00  : 

:  00 

: f a : ce : 

:  04  : 

;83: 

:c9;  0 

FC4s:    FCP    [STOREX  RS2999FCPH3 

NS09] 

Fabric  Port  Name:  20:04:00:60:69 

:01:44:22 

Device  type:   Physical  Target 

NL       0214ef;             3 ; 21 : 00 : 00 : ad: be : 

04:6f :70;20: 

;  00  : 

:  00 

: ad:bc : 

:  04  : 

:6f  : 

:70;  0 

FC4s:    FCP    [STOREX  RS2999FCPH3 

JB09] 

Fabric  Port  Name:  20:04:00:60:69 

:01:44:22 

'Pl;:^T7"n               4-  -\  rr-^  ^  *       "DViazOt       ^  "1       rn  — >  -y^^^  4— 

The  Local  Name  Server  has  6  entries  } 

See  also 

nsAllShow 
switchShow 
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nsZoneMember 

Displays  the  information  of  all  the  online  devices  zoned  with  the  given  device. 

Synopsis 

nszonemember  -a    |    -u    |  pid  \  wwn 

Availability 

all  users 

Description 

Use  this  command  to  display  information  about  all  the  online  devices  zoned  v/ith  the  given  device.  Issuing 
this  command  v/ithout  operands  displays  all  online  devices  zoned  with  the  given  device.  Each  line  of 
output  displays: 


Type  U  for  unknown,  N  for  N  Port,  NL  for  NL  Port 

Pid  The  24-bit  Fibre  Channel  address 

COS  A  list  of  classes  of  service  supported  by  the  device 

PortName  The  device's  port  World  Wide  Name 

NodeName  The  device's  node  World  Wide  Name 

DeviceType  The  device's  type 


There  might  be  additional  lines  if  the  device  has  registered  any  of  the  following  information  (the  switch 
automatically  registers  SCSI  inquiry  data  for  FCP  target  devices): 

•  FC4  supported 

•  IP  address  (node) 

•  IPA 

•  port  and  node  symbolic  name  (local  device  only) 

•  fabric  port  name 

•  hard  address  and/or  port  IP  address 

Operands 

This  command  has  the  following  operands: 

-a  Displays  each  local  device's  online  zoned  device  data,  including  the  PID 

and  zone  alias. 

-u  Displays  all  the  unzoned  devices  in  the  entire  fabric.  The  device  data 

displayed  includes  the  device  PID  and  zone  alias. 

pid  I  wwn  Specifies  the  port  ID  or  WWN,  respectively,  whose  zoned  devices  are  to 

be  viewed.  This  operand  is  required. 
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Examples 

To  display  the  information  of  all  the  online  devices  zoned  with  the  given  device: 


switch : admin>  nszonemember  Ox0416e2 

3  local  zoned  members : 

Type  Pid        COS          PortName  NodeName 

T 

NL       041901;          2 , 3 ; 10 : 00 : GO : 00 :c9 :26 : Oe:ae;20 : GO ; 

:00: 

;  00 

:c9 

:26: 

:0e; 

:  ae; 

n 

raDnc   fOTZ  iNiame  ;    zU  :  uy  :  UU  :  oU  ;  oy  :  oU  :  Uo  :  /o 

NL       0416e2;  3;22:00:G0:2G:37:d9:6b:b3;2G:G0: 

:00: 

:20 

:37 

:d9: 

:6b; 

:b3; 

n 

FC4s:    FCP    [SEAGATE  ST318304FC  0005] 

Fabric  Port  Name:  20:06:00:60:69:50:06:78 

NL       0416e4;  3;22:00:00:20:37:d9:61:ac;20:00; 

:00: 

:  20 

:  37 

:d9  : 

:  61  : 

:  ac ; 

n 

FC4s:    FCP    [SEAGATE  ST318304FC  0005] 

Fabric  Port  Name:  20:06:00:60:69:50:06:78 

No  remote  zoned  members 

To  display  the  information  of  all  the  online  devices  zoned  with  the  given  WWN: 


switch: 

admin>  nszonemember  10:00:00:00 

:c8:23:0b:ad 

3 

local  zoned  members : 

Type  Pid        COS  PortName 

NodeName 

SCR 

NL 

041901; 

2, 3, -10: 

00:00:00: C9:26:0e:ae; 20:00: 00:00: 

c9:26:0e:ae;  3 

Fabric  Port  Name:  20:09:00:60: 

69 

:50:06:78 

Device  type:   Physical  Initiator 

NL 

0416e2 ; 

3;22:00 

:00:20:37:d9: 6b :b3; 20:00:00:20: 

37 

:d9:6b:b3;  0 

FC4s:    FCP    [SEAGATE  ST318304FC 

0005] 

Fabric  Port  Name:  20:06:00:60: 

69 

:50:06:78 

Device  type:  Physical  Target 

NL 

0416e4; 

3;22:00 

:00:20:37:d9:61:ac; 20:00:00:20: 

37 

:d9:61:ac;  0 

FC4s:    FCP    [SEAGATE  ST318304FC 

0005] 

Device  type:   Physical  Target 

No 

remote  zoned  members 
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To  display  each  local  device's  online  zoned  device  data: 


switch 

admin>  nszonemember  -a 

Port : 

4  Pid 

Oxb00400        Aliases:  ix360_131_201_6a 

Zoned 

Members :  2  devices 

Pid:  Oxb00400 

Aliases:  ix360_131_201_6a 

Pid:  OxbaleeS 

Aliases:  trimml01b_3 

Port : 

12 

Pid:  OxbOOcOl 

Aliases:  dl360_130159a 

Zoned 

Members :   2  devices 

Pid:  OxbOOcOl 

Aliases:  dl360_130159a 

Pid:  Oxbdlbef 

Aliases:  nstor4b_8 

Port : 

13 

Pid:  OxbOOdOO 

Aliases:  ix360_131_196p5 

Zoned 

Members:   2  devices 

Pid:  OxbOOdOO 

Aliases:  ix360_131_196p5 

Pi  rl  -  Dvp^DTHnn 

Aliases:  hds9200_6p4  hds9200_ 

_6p4 

Port : 

14 

Pid:  OxbOOeOO 

Aliases:   dl360_130251a  dl360_130251a 

Zoned 

Members:  2  devices 

Pid:  OxbOOeOO 

Aliases:  dl360_130251a  dl360_ 

_130251a 

Pid:  Oxbalae4 

Aliases:  trimml00a_2 

To  display  all  the  unzoned  devices  in  the  fabric: 


switch : admin>  nszonemember  -u 


Pid: 

0xb01ea9; 

Aliases : 

trimm32b_ 

1 

Pid: 

OxbOleaa; 

Aliases : 

trimm32b_ 

_2 

Pid: 

OxbOleab; 

Aliases : 

trimm32b_ 

3 

Pid: 

OxbOleac ; 

Aliases : 

trimm32b_ 

_4 

Pid: 

OxbOlfad; 

Aliases : 

trimm32a_ 

_5 

Pid: 

OxbOlfae; 

Aliases : 

trimm32a_ 

_6 

Pid: 

OxbOlfbl; 

Aliases : 

trimm32a_ 

1 

Pid: 

0xb01fb2 ; 

Aliases : 

trimm32a_ 

_8 

Pid: 

0xdc2800; 

Aliases : 

Totally  9  unzoned  devices  in  the  fabric. 

See  also 

cf gShow 

nscamShow 

nsShow 
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numSwitchSet 

Sets  number  of  switches  configured. 

Synopsis 

numSwitchSet 

Availability 

admin 

Description 

This  command  is  to  set  how  many  switches  configured  in  the  chassis. 
Operands 

none 

Examples 

To  set  the  number  of  switches  configured: 

switch : admin>  numSwitchSet 
Number  of  Switch:    (1..2)    [1]  2 

Set  number  of  switch  to  2  successfully 

See  also 

numSwitchShow 
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numSwitchShow 

Displays  number  of  switches  are  configured. 

Synopsis 

numSwitchShow 

Availability 

admin 

Description 

This  command  displays  how  many  switches  are  configured  in  the  chassis. 
Operands 

none 

Examples 

To  display  the  number  of  configured  switches  in  the  chassis: 

switch :  adinin>  numSwitchShow 

Chassis  is  configured  with  2  switches. 

See  also 

numSwitchSet 
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passwd 

Changes  the  password  for  a  user  level. 

Synopsis 

passwd  ["user"] 

Availability 

all  users 

Description 

Use  this  command  to  change  the  password  for  the  user  currently  logged  in  or  for  another  user.  To  change 
the  password  for  a  specific  user,  enter  the  command  with  the  optional  user  operand. 

Users  logging  in  to  the  system  by  way  of  RADIUS  are  allowed  to  change  the  passwords  of  the  roles  they 
log  in;  for  example,  if  a  user's  role  in  RADIUS  is  admin,  and  this  command  is  executed,  the  system 
prompts  for  the  old  admin  password.  This  command  changes  the  passwords  in  the  switch  database  only. 

The  hierarchy  of  user  levels  are  (from  greatest  access  to  least)  root,  factory,  admin,  and  user.  Typically,  all 
fabric  management  should  be  performed  by  admin. 

When  the  root  password  is  changed,  all  user  levels  currently  logged  in  are  terminated. 
If  the  fabric  is  not  in  secure  mode,  the  behavior  of  the  command  is  as  follows: 

•  If  you  are  changing  your  own  user-level  password,  you  are  prompted  to  enter  the  old  password  and,  if 
your  entry  is  valid,  the  new  password. 

•  If  a  you  are  changing  another  user-level  password,  you  are  prompted  to  enter  that  user  level's  old 
password  and,  if  your  entry  is  valid,  the  new  password. 

•  If  you  are  logged  in  as  the  root  user  when  changing  another  user-level  password,  you  are  not 
prompted  to  enter  the  old  password. 

•  The  command  is  disabled  until  you  have  changed  all  the  login  passwords  from  the  manufacture  default 
values. 

If  the  fabric  is  in  secure  mode,  the  behavior  of  the  command  is  as  follows: 

•  The  command  can  only  be  run  on  the  primary  FCS  switch.  The  changed  passwords  will  be  distributed 
to  all  FCS  switches.  NonFCS  switches  will  be  updated  if  the  password  of  the  user  account  is  changed. 

•  Changing  the  password  of  any  user  level  causes  the  login  session  of  that  account  (if  logged  in)  to  be 
terminated. 

NOTE:  If  the  Security  option  is  enabled  on  the  fabric,  this  command  is  disabled  on  all  switches  except  the 
primary  FCS. 

A  new  password  must  follow  these  rules: 

•  Have  8  to  40  characters 

•  Be  different  from  the  previous  password 
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Use  the  following  keys  to  control  input: 

Return  When  entered  at  a  prompt  with  no  preceding  input,  accepts  the 

default  value  (if  applicable)  and  moves  to  the  next  prompt. 

Ctrl+D  (end-of-file)  When  entered  at  a  prompt  with  no  preceding  input,  terminates 

the  command  without  changing  the  password.  This  is  valid  on 
most  computers;  however,  your  settings  could  be  different. 

Operands 

This  command  has  the  following  operand: 

user  Specify  the  name  of  the  user,  in  quotation  marks,  for  which  you  want  to 

modify  the  password.  This  operand  is  optional.  Valid  values  are  root, 
factory,  admin,  or  user. 

You  can  only  specify  this  operand  when  you  are  logged  in  as  root, 
factory,  or  admin.  If  you  try  to  change  the  password  of  a  user  level 
higher  in  the  hierarchy  (for  example,  you  are  admin  and  attempting  to 
change  the  root  password),  you  are  prompted  to  enter  the  current 
password  of  that  level.  If  you  try  to  change  the  password  of  a  user  level 
lower  in  the  hierarchy,  you  are  not  prompted  to  enter  the  current 
password. 

Examples 

To  change  the  password  for  the  admin  user: 

switch : admin>  passwd  "admin" 
Changing  password  for  admin 
Enter  new  password: 
Re-type  new  password: 
Password  changed. 

Saving  password  to  stable  storage. 

Password  saved  to  stable  storage  successfully. 

Diagnostics 

When  failures  are  detected,  the  subtext  might  report  one  or  more  of  the  following  error  messages: 

"user"  is  not  a  valid  user  name.     You  have  not  specified  a  user  name  that  is  a 

valid,  recognized  user  name  on  the  system. 

Permission  denied.  You  do  not  have  permission  to  change  the  login 

name  or  password  specified. 

Incorrect  password.  You  have  not  entered  the  correct  password  when 

prompted  for  the  old  password. 

Password  unchanged.  You  have  entered  the  carriage  return  special  input 

case,  choosing  not  to  change  the  password. 

Passwords  do  not  match.  You  have  not  correctly  verified  the  new  password. 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

login 
logout 
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path  Info 

Display  routing  and  statistics  information  along  a  path,  covering  multiple  switches. 

Synopsis 

pathinfo  [domain]    [src^ortnuniber]    [dst^ortnumber]  [-r] 

Availability 

admin 

Description 

Use  this  command  to  display  detailed  routing  information  from  a  source  port  or  area  on  the  local  switch  to 
a  destination  port  or  area  on  another  switch.  This  routing  information  describes  the  exact  path  that  a  user 
data  stream  takes  to  go  from  the  source  port  to  the  destination  port,  including  all  intermediate  switches. 

The  command  does  not  make  any  retry  attempts  if  there  is  a  timeout  or  failure.  It  might  fail  if  a  switch 
along  the  path  is  busy;  for  instance,  performing  a  warm  recovery. 

[2^^  NOTE:    If  the  advanced  performance  tuning  (APT)  policy  in  effect  on  the  intermediate  switches  is  not  a 
port-based  policy,  subsequent  data  streams  might  not  take  the  same  path  as  displayed  in  the  pathinfo 
output. 

Refer  to  aptPolicy  for  more  information  on  advanced  performance  tuning  policies. 


If  you  specify  an  inactive  port  or  a  path  through  a  switch  that  does  not  have  active  routing  tables  to  the 
destination,  this  command  displays  the  path  that  would  be  used  if  the  ports  were  active.  If  you  specify  a 
destination  port  that  is  not  active,  this  command  uses  the  embedded  port  as  the  destination. 

For  bladed  systems,  the  ingress  and  egress  points  are  specified  as  area  numbers.  For  nonbladed  systems, 
ingress  and  egress  points  are  specified  as  ports.  This  agrees  with  the  representation  displayed  by  the 
switchShow  command. 

In  addition,  pathinfo  can  provide,  upon  request,  statistics  on  every  traversed  Inter-Switch  Link  (ISL)  that  is 
part  of  the  path.  This  feature  is  available  in  interactive  mode  only. 

The  routing  and  statistics  information  are  provided  by  every  switch  along  the  path,  based  on  the  current 
routing-tables  information  and  statistics  calculated  continuously  in  real-time.  Each  switch  represents  one 
hop  of  the  total  path. 

Other  options  allow  the  collection  of  information  on  the  reverse  path,  or  on  a  user  selected  path  (source 
route) . 

For  each  hop,  the  routing  information  output  includes  the  following: 
Hop  The  hop  number.  The  local  switch  is  hop  0. 

In  Port  The  port  or  area  from  which  the  switch  receives  frames.  For  hop  0, 

this  is  src_portnumber.  For  bladed  systems,  this  is  specified  as  the 
area  number;  otherwise,  it  is  the  port  number. 

Domain  ID  The  domain  ID  of  the  switch. 

Name  The  name  of  the  switch. 

Out  Port  The  output  port  that  the  frames  use  to  reach  the  next  hop.  For  the  last 

hop,  this  is  dst  portnumber.  For  bladed  systems,  this  is  specified  as 
the  area  number;  otherwise,  it  is  the  port  number. 
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BW  The  bandwidth  of  the  output  ISL,  in  Gb/s.  It  does  not  apply  to  the 

embedded  port. 

Cost  The  cost  of  the  output  link  used  by  FSPF  routing  protocol.  Only 

applicable  if  the  output  link  is  currently  recognized  by  FSPF. 

When  requested,  statistics  are  reported  below  the  routing  information  for  each  hop.  These  statistics  are 
presented  for  both  the  input  and  output  ports,  for  both  receive  and  transmit  modes.  These  statistics  are 
divided  into  basic  and  extenc/ed  statistics,  which  can  be  individually  requested  in  interactive  mode. 
Statistics  are  not  reported  for  the  embedded  port. 

To  collect  these  statistics,  this  command  uses  a  special  frame,  the  pathinf  o  frame,  that  is  sent 
hop-by-hop  from  the  source  switch  to  the  destination  switch.  In  order  to  prevent  such  a  frame  to  loop 
forever  if  an  error  occurs,  a  maximum  number  of  hops  for  the  frame  to  traverse  is  enforced.  The  hop  count 
includes  all  hops  in  the  direct  path  from  source  to  destination,  and  also  all  the  hops  in  the  reverse  path,  if 
the  tracing  of  the  reverse  path  is  requested.  The  default  value  for  the  maximum  hop  count  is  25. 

Basic  statistics  Basic  statistics  report  variables  that  give  an  indication  of  ISL 

congestion  along  the  path.  They  include  the  following: 

B/s  Bytes  per  second  received  or  transmitted;  reports  for 

multiple  time  periods,  displayed  in  parentheses. 

Txcrdz  The  length  of  time  in  milliseconds  that  the  port  has  been 

prevented  from  transmitting  frames  due  to  lack  of 
buffer-to-buffer  credit.  It  is  an  indication  of  downstream 
congestion.  This  value  reports  for  multiple  time  periods, 
displayed  in  parentheses.  Note  that  other  commands, 
such  as  portStatsShow,  might  express  this  value  in 
units  other  than  milliseconds. 

Extended  statistics  Extended  statistics  report  variables  of  general  interest.  They  include  the 

following: 

F/s  Frames  per  second  received  or  transmitted;  reports  for 

multiple  time  periods,  displayed  in  parentheses. 

Words  Total  number  of  4-byte  Fibre  Channel  words. 

Frames  Total  number  of  frames. 

Errors  Total  number  of  errors  that  might  cause  a  frame  not  to 

be  received  correctly.  This  includes  CRC  errors,  bad 
EOF  errors,  frame  truncated  errors,  frame-too-short 
errors,  and  encoding  errors  inside  a  frame. 

Reverse  path  In  general,  the  path  from  port  A  on  switch  X  to  port  B  on  switch  Y 

might  be  different  from  the  path  from  port  B  to  port  A.  The  difference 
could  be  in  the  links  traversed  between  the  same  sequence  of 
switches,  or  the  reverse  path  might  even  involve  different  switches.  The 
-r  option  allows  the  user  to  determine  both  routing  and  statistics 
information  for  the  reverse  path,  in  addition  to  those  for  the  direct 
path. 

Source  route  The  source  route  option  allows  the  user  to  specify  a  sequence  of 

switches,  ports,  or  areas  that  the  pathinf  o  frame  has  to  traverse  to 
reach  the  destination.  Therefore,  the  path  might  be  different  from  the 
one  used  by  actual  traffic. 

The  source  route  is  expressed  as  a  sequence  of  switches,  a  sequence 
of  output  ports  or  areas,  or  a  combination  thereof.  The  next  hop  in  the 
source  route  is  described  by  either  the  output  port  or  area  to  be  used 
to  reach  the  next  hop,  or  the  domain  ID  of  the  next  hop. 
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The  source  route  can  specify  a  partial  route  from  source  to  destination 
(in  which  case  the  remaining  hops  are  chosen  as  the  path  from  the 
input  port  or  area  on  the  first  hop  not  listed  in  the  source  route  to  the 
destination),  as  a  full  route,  or  as  an  arbitrary  route  across  the  fabric. 
The  maximum  hop  count  is  enforced. 

If  the  source  route  does  not  specify  all  the  switches  along  a  section  of 
the  path,  a  further  option  allows  to  specify  a  strict  versus  a  loose  path. 
A  strict  source  route  requires  that  only  the  specified  switches  are 
reported  in  the  path  description.  If  two  switches  are  specified  back  to 
back  in  the  source  route  descriptor,  but  are  not  directly  connected,  the 
switches  in  between  will  be  ignored.  In  case  of  a  loose  source  route, 
the  switches  in  between  will  be  reported.  The  concepts  of  strict  and 
loose  route  apply  to  the  portion(s)  of  the  path  described  by  domains, 
not  to  the  part  described  by  output  ports  or  areas. 


Operands 


The  following  operands  are  optional 


domain 


src_portnuinber 


ID  of  the  destination  domain.  If  omitted,  the  command  prompts 
for  all  operands,  including  whether  basic  and  extended  statistics 
should  be  included. 

Port  or  area  whose  path  to  the  destination  domain  is  sought.  The 
default  is  embedded  port  (-1).  For  bladed  systems,  the 
destination  is  specified  as  the  area;  otherwise,  it  is  the  port.  If 
the  source  port  is  -1  with  no  additional  arguments,  basic 
statistics  display  for  the  route. 

Port  or  area  on  the  destination  switch  for  each  path  being 
traced.  This  command  returns  the  state  of  this  port  or  area.  The 
default  is  embedded  port  (-1 ),  or  if  a  destination  port  is  specified 
that  is  not  active.  For  bladed  systems,  the  destination  is  specified 
as  the  area;  otherwise,  it  is  the  port. 

"-r"  Display  reverse  path  in  addition  to  forward  path. 

Without  operands,  pathinf  o  prompts  for  the  preceding  operands.  The  value  of  domain  is  mandatory; 
the  values  for  the  source  and  destination  ports  can  be  -1 ,  to  indicate  the  embedded  port.  Reverse-path 
tracing  remains  optional.  In  addition,  this  command  prompts  for  following  parameters: 


ds t_portnumber 


max  hops 
basic  stats 
extended  stats 
source  route 


strict  source  rte 


Timeout 


The  maximum  number  of  hops  that  the  pathinf  o  frame  is 
allowed  to  traverse;  default  is  25. 

Requests  the  reporting  of  basic  statistics  on  every  link;  default  is 
no. 

Requests  the  reporting  of  extended  statistics  on  every  link; 
default  is  no. 

Specifies  a  sequence  of  switches  or  ports  that  the  pathinf  o 
frame  should  traverse;  default  is  no.  Note  that  if  an  output  port 
(or  area)  to  the  next  hop  is  specified,  the  user  is  not  prompted  for 
the  domain  of  the  next  switch,  which  is  determined  by  the  port 
(or  area)  specified. 

Specifies  that  the  source  route  must  be  followed  strictly  as 
indicated,  skipping  possible  intermediate  switches.  When  using 
this  option,  the  source  route  hops  must  be  specified  using 
domain  rather  than  output  port. 

The  maximum  time  allowed  to  wait  for  the  response;  default  is 
1 0  seconds. 
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Examples 


To  display  basic  path  information  to  a  specific  domain,  using  the  command  line  (noninteractive  mode): 


switch :  adinin>  pathinfo  91 
Target  port  is  Embedded 


Hop     In  Port     Domain  ID   (Name)             Out  Port 

BW 

Cost 

0              E                  9    (web226)  2 

IG 

1000 

1              3                10    (web229)  8 

IG 

1000 

Z                        o                              O      [W^LJAAO)  y 

1  P 

1  n  n  n 
±  u  u  u 

O                        D                           J3  J-      \Wfc:JJZZ3^  Hj 

1^  UloL^IUy   UUolC  UIIU  CAIC^I  lUCU  OIUIIOIICo  UolllU   IllldU^IIVC  III^U 

c 

switch :  ad[nin>  pathinfo 

Max  hops:    (1. .127)  [25] 
Domain:    (1..239)    [-1]  8 

Source  port:    (0..15)  [-1] 

Destination  port:    (0..255)  [-1] 

Basic  stats    (yes,   y,   no,   n) :    [no]  y 

Extended  stats    (yes,   y,   no,   n) :    [no]  y 

Trace  reverse  path   (yes,   y,   no,   n) :  [no] 

Source  route   (yes,   y,   no,   n) :  [no] 

Timeout:    (1. .30)  [5] 

Target  port  is  Embedded 

Hop     In  Port     Domain  ID   (Name)             Out  Port 

BW 

Cost 

0              E                  9    (web22  6)  2 

IG 

1000 

Port  E 

2 

Tx 

Rx 

Tx 

Rx 

B/s  (Is) 

0 

0 

B/s  (64s) 

1 

1 

Txcrdz  (Is) 

0 

Txcrdz  (64s) 

- 

0 

F/s  (Is) 

0 

0 

F/s  (64s) 

2743 

0 

Words 

2752748 

2822763 

Frames 

219849 

50881 

Errors 

0 

(continued  on  next  page) 
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Hop     In  Port  Domain 

ID  (Name) 

Out  Port 

BW 

Cost 

1  in 

/■tatoK9  9  Q  ^ 

xz 

1  n  n  n 
X  u  u  u 

Port 

3 

12 

P-v- 

rS/  S     ^  -LS  J 

o  o 

/  D 

A 
U 

U 

rS/  S     ^  O 4± S  ^ 

C 

D 

A 
U 

A 
U 

1  XC_X  U.Z      ^  D     o  ^ 

u 

A 
U 

r  /  S    \  -LS  ) 

1 
J- 

-1 
J_ 

A 
U 

u 

A 
U 

A 
U 

A 
U 

n 
u 

TaT    "V"  o 

Z  Z  J  ^  J  ±  0 

91  1  Q  Q  m 

91  91  7  7 
Z  X  Z  X  /  D  / 

Frames 

20025929 

54999 

152338 

56710 

Errors 

4 

0 

Jnop        J-Ii    irOX  L  iJOiLLa.-LIi 

±LJ     \  IMaiLlt;  J 

UU  U     Jr  OX  L 

l„Oo  L- 

2             14  8 

(web22  8) 

E 

{ output  truncated) 

See  also 

port stats Show 
switchShow 
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pdShow 

Displays  data  from  a  panic  dump  file. 

Synopsis 

pdshow  [panic-dump- file] 

Availability 

admin 

Description 

Use  tfiis  command  to  display  data  from  a  panic  dump  file.  The  panic  dump  file  contains  information  that 
might  be  useful  to  determine  the  cause  of  the  system  panic. 

When  executed  without  any  arguments,  this  command  displays  output  from  the  latest  panic  dump  file 
available  on  the  switch. 

If  a  panic  dump  file  is  specified  as  an  argument,  the  contents  of  that  specific  file  are  displayed. 

Operands 

This  command  has  the  following  operand: 

panic-dump- file  Specify  the  full  path  name  of  a  panic  dump  file.  This  operand  is 

optional. 

Examples 

To  examine  a  panic  dump  file  by  the  name  panic_dump  located  under  the  directory  /tmp: 

switch : admin>  pdshow  / tmp/panic_dump 

***  CAUTION  *** 

*  Host     PLATFORM      (current)    is:  'Unknown' 

*  PLATFORM  got  from  pd  file  is:  'SW12000' 

*  Some  results  shown  may  be  incorrect  and/or  missing 

*  It  is  best  if  this  command  is  run  on  same  PLATFORM  as  that  of  pdfile 

************** 

******** 

*  File       : /core_f iles/panic/core.pdl038932352  * 

*  SECTION: PD_MISC  * 
 ********  

WatchDogRegister=OxO 

Section=Startup  time:   Tue  Dec     3  16:06:11  UTC  2002 

Kernel=  2.4.19 

Fabric  0S=     v4 . 1 . 0_j_dist_1103 

Made  on=         Tue  Dec  3  19:07:13  2002 

Flash=  Tue  Dec  3   13:19:06  2002 

BootProm=  3.2.0 

Section=HA  show  Output 

(output  truncated) 
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See  also 

portLogDump 
saveCore 
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perf Add  EEMon  itor 


Adds  an  end-to-end  monitor  to  a  port. 

Synopsis 

perf addeemoni tor  [slotnumber/] portnuraber  SourcelD  DestID 

Availability 

admin 


NOTE:    This  command  requires  a  Performance  Monitor  license 


Description 

Use  this  command  to  add  an  end-to-end  performance  monitor  to  a  port.  The  performance  monitor  counts 
the  number  of  words  received,  number  of  words  transmitted,  and  number  of  CRC  errors  detected  using 
either  of  the  following  two  conditions: 

•  For  frames  received  at  the  port,  the  frame  SID  is  the  same  as  SourcelD  and  frame  DID  is  the  same  as 
DestID,  both  RX_COUNT  and  CRC_COUNT  will  be  updated  accordingly.  Note  that  the  CRC_COUNT 
counts  the  CRC  errors  detected  with  the  frames  received  at  or  transmitted  from  the  associated  port. 

•  For  frames  transmitted  from  the  port,  the  frame  DID  is  the  same  as  SourcelD  and  frame  SID  is  the  same 
as  DestID,  both  TX_COUNT  and  CRC_COUNT  will  be  updated  accordingly. 

To  monitor  traffic  from  host  A  to  device  B,  add  a  monitor  on  port  2,  specifying  0x050200  as  the  SID  and 
0x01 01 00  as  the  DID.  The  RX  count  equals  the  number  of  words  from  host  A  to  device  B,  whereas  the  TX 
count  equals  the  number  of  words  from  device  B  to  host  A.  The  CRC  count  equals  the  total  number  of  CRC 
errors  for  both  directions.  Adding  a  monitor  on  port  1,  specifying  0x010100  as  SID  and  0X050200  as 
the  DID  has  a  similar  effect,  except  the  RX  and  TX  counts  are  interchanged. 

If  ISL  monitoring  is  enabled,  end-to-end  monitors  cannot  be  added  to  E  Ports.  Existing  end-to-end  monitors 
on  E  Ports  are  deleted. 

Identical  monitors  cannot  be  added  to  the  same  port.  Two  monitors  are  considered  identical  if  they  have 
the  same  SID  and  DID  values  after  applying  the  end-to-end  mask. 

After  a  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  performance  monitors. 


Operands 


This  command  has  the  following  operands: 


slotnumber 


portnumber 


SourcelD 


For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be 
added,  relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a 
list  of  valid  ports. 

Specify  the  3-byte  SID  (Source  ID)  of  the  originator  device.  It  should 
be  in  OxDDAAPP  format,  where  DD  is  domain  ID,  AA  is  area  ID  and 
PP  is  AL_PA  ID.  For  example,  0x050200  has  a  domain  ID  of  5,  an 
area  ID  of  2,  and  an  AL  PA  ID  of  0.  SourcelD  and  DestID  both 
cannot  be  0x000000. 
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DestiD  Specify  the  3-byte  DID  (destination  ID)  of  the  destination  device.  It 

should  be  in  OxDDAAPP  format,  where  DD  is  domain  ID,  AA  is  area 
ID  and  PP  is  AL_PA  ID.  For  example,  0x050200  has  a  domain  ID  of 
5,  an  area  ID  of  2,  and  an  AL_PA  ID  of  0.  SourcelD  and  DestID  both 
cannot  be  0x000000. 

Optionally,  a  comma  can  separate  the  operands.  SourcelD  and  DestiD  also  can  be  enclosed  in 
quotation  marks.  A  space  is  required  to  separate  the  operands  even  v/hen  using  commas. 

Examples 

To  add  an  end-to-end  monitor  to  blade  1  port  2: 

switch : admin>  perf addeemonitor  1/2   "0x050200"  "0xll82ef" 
End-to-End  monitor  nuitiber  0  added. 

See  also 

perf AddlPMoni tor 
perf AddReadMoni tor 
p e r f AddRWMon i t o r 
perfAddSCSIMonitor 
perf AddUserMoni tor 
perf AddWriteMonitor 
perf ClearEEMoni tor 
perf DelEEMoni tor 
perf ShowEEMoni tor 
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perfAddlPMonitor 


Adds  a  filter-based  performance  monitor  for  IP  frame  count. 

Synopsis 

perf  addipmonitor  [slotnumber/]  portnuraber  [alias] 

Availability 

admin 


r?p^  NOTE:    This  command  requires  a  Performance  Monitor  license. 


Description 

Use  tfiis  command  to  define  filter-based  monitors  to  count  the  number  of  IP  traffic  frames.  Only  frames 
transmitted  are  counted. 

After  a  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  filter-based  performance  monitors.  The  optional  user-defined  alias  is 
also  displayed,  if  one  is  specified.  All  valid  monitor  numbers  and  user-defined  aliases  can  be  displayed 
v/ith  the  perf  ShowFilterMonitor  command. 

The  maximum  number  of  filters  is  eight  per  port,  including  user-defined  filters,  read  filters,  write  filters, 
read/v/rite  filters,  SCSI  frame  monitor,  and  IP  frame  monitor. 

Operands 

The  operands  are  as  follov/s: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

alias  Specify  a  name  for  this  monitor.  This  string  truncates  to  a  maximum  of  1 0 

characters.  It  might  be  surrounded  by  quotation  marks,  in  order  to 
include  spaces.  This  operand  is  optional.  The  default  alias  is  IP 

Frame . 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  add  an  IP  monitor  to  a  port: 

switch :adinin>  perf addipmonitor  1/4  "IP_MONITOR" 
IP  traffic  frame  monitor  #0  added 
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See  also 

perf AddEEMonitor 
perf AddReadMonitor 
perf AddRWMoni tor 
perfAddSCSIMonitor 
perf AddUserMoni tor 
perf AddWriteMonitor 
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perfAddReadMonitor 


Adds  a  filter-based  performance  monitor  for  the  SCSI  Read  command. 

Synopsis 

perf  addreadmonitor  [slotnumber/]  portnuiaber  [alias] 

Availability 

admin 


^^^^  NOTE:    This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  define  filter-based  monitors  to  count  the  number  of  SCSI  FCP  Read  commands  in 
Fibre  Channel  frames.  Only  frames  transmitted  are  counted. 

After  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  filter-based  performance  monitors.  The  optional  user-defined  alias  is 
also  displayed,  if  one  was  specified.  All  valid  monitor  numbers  and  user-defined  aliases  can  be  retrieved 
v/ith  the  perf  ShowFilterMonitor  command. 

The  maximum  number  of  filters  is  eight  per  port  including  user-defined  filters,  read  filters,  write  filters, 
read/write  filters,  SCSI  frame  monitor,  and  IP  frame  monitor. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

alias  Specify  a  name  for  this  monitor.  This  string  truncates  to  a  maximum  of  1 0 

characters.  It  might  be  surrounded  by  quotation  marks,  in  order  to 
include  spaces.  This  operand  is  optional.  The  default  alias  is  SCSI 
Read. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 


Examples 

To  add  a  SCSI  read  monitor  to  a  port: 


switch : adinin>  perf addreadmonitor  2/4  "SCSI_R" 
SCSI  Read  filter  monitor  #2  added 
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See  also 

perf AddEEMonitor 
perf AddlPMonitor 
perf AddRWMoni tor 
perfAddSCSIMonitor 
perf AddUserMoni tor 
perf AddWriteMonitor 
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perfAddRWMonitor 


Adds  a  filter-based  performance  monitor  for  the  SCSI  read  and  write  commands. 

Synopsis 

perf addrwmonitor    [slotnumber/] portnumber  [alias] 

Availability 

admin 


^^^^  NOTE:    This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  define  filter-based  monitors  to  count  the  number  of  SCSI  FCP  Read  and  Write 
commands  in  Fibre  Channel  frames.  Only  frames  transmitted  are  counted. 

After  a  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  filter-based  performance  monitors.  The  optional  user-defined  alias  is 
also  displayed,  if  one  was  specified.  All  valid  monitor  numbers  and  user-defined  aliases  can  be  retrieved 
with  the  perf  ShowFilterMonitor  command. 

The  maximum  number  of  filters  is  eight  per  port,  including  user-defined  filters,  read  filters,  write  filters, 
read/write  filters,  SCSI  frame  monitor,  and  IP  frame  monitor. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

alias  Specify  a  name  for  this  monitor.  This  string  truncates  to  a  maximum  of  1 0 

characters.  It  might  be  surrounded  by  quotation  marks,  in  order  to 
include  spaces.  This  operand  is  optional.  The  default  alias  is  SCSI  R/w. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  add  a  SCSI  read  and  write  monitor  to  a  port: 

switch : adinin>  perf addrwmonitor  2/4  "SCSI_RW" 
SCSI  Read/Write  monitor  #1  is  added 
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See  also 

perf AddEEMonitor 
perf AddlPMonitor 
perf AddReadMoni tor 
perfAddSCSIMonitor 
perf AddUserMoni tor 
perf AddWriteMonitor 
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perfAddSCSIMonitor 

Adds  a  filter-based  performance  monitor  for  SCSI  frame  count. 

Synopsis 

perf addscsimonitor    [slotnumber/] portnumber  [alias] 

Availability 

admin 


NOTE:    This  command  requires  a  Performance  Monitor  license. 


Description 

Use  tfiis  command  to  define  filter-based  monitors  to  count  the  number  of  SCSI  traffic  frames.  Only  frames 
transmitted  are  counted. 

After  a  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  filter-based  performance  monitors.  The  optional  user-defined  alias  is 
also  displayed,  if  one  was  specified.  All  valid  monitor  numbers  and  user-defined  aliases  can  be  retrieved 
v/ith  the  perf  ShowFilterMonitor  command. 

The  maximum  number  of  filters  is  eight  per  port,  including  user-defined  filters,  read  filters,  write  filters, 
read/write  filters,  SCSI  frame  monitor,  and  IP  frame  monitor. 


Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

alias  Specify  a  name  for  this  monitor.  This  string  truncates  to  a  maximum  of  1 0 

characters.  It  might  be  surrounded  by  quotation  marks,  in  order  to 
include  spaces.  This  operand  is  optional.  The  default  alias  is  SCSI 
Frame. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  add  a  SCSI  traffic  frame  monitor  to  a  port: 

switch : adinin>  perf addscsimonitor  2/4  "SCSI_FR" 
SCSI  traffic  frame  monitor  #0  added 
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See  also 

perf AddEEMonitor 
perf AddlPMonitor 
perf AddReadMoni tor 
p e r f AddRWMon i t o r 
perf AddUserMoni tor 
perf AddWriteMonitor 
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perfAddUserMonitor 

Adds  a  user-defined  filter-based  performance  monitor. 

Synopsis 

perf addusermonitor  [slotnumber/] portnuiaber  " grouplist"  [alias] 

Availability 

admin 


NOTE:    This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  define  a  custom  filter  for  frame  offsets  and  values. 

For  every  offset,  each  group  of  comparison  values  is  OR-ed  together  to  determine  a  match.  If  there  are 
multiple  offsets,  each  resulting  OR  function  is  AND-ed  to  determine  if  the  entire  statement  is  true,  thus 
incrementing  the  counter. 

After  a  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  filter-based  performance  monitors.  The  optional  user-defined  alias  is 
also  displayed,  if  one  was  specified.  All  valid  monitor  numbers  and  user-defined  aliases  can  be  retrieved 
with  the  perf  ShowFilterMonitor  command. 

The  maximum  number  of  filters  is  eight  per  port  including  user  defined  filters,  read  filters,  write  filters, 
read/write  filters,  SCSI  frame  monitor,  and  IP  frame  monitor.  In  addition,  there  should  be  no  more  than  six 
different  offsets  for  each  filter  and  no  more  than  four  different  values  per  offset  defined  by  the  user. 


Operands 


This  command  has  the  following  operands: 


slotnumber 


portnumber 


"grouplist ' 


For  bladed  systems  only,  this  operand  specifies  the  slot  number  of 
the  port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash 
(/)■ 

Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be 
added,  relative  to  its  slot  for  bladed  systems.  Use  switchshow 
for  a  list  of  valid  ports. 

Specify  up  to  six  sets  of  offset,  mask,  and  ValueList,  separated  by 
semicolons  (;). 

The  entire  grouplist  operand  must  be  enclosed  in  quotation  marks. 
This  operand  is  required. 

For  example: 

4,    Oxff,    0x22;    12,    Oxff,  0x01 

The  grouplist  component  values  are  as  follows: 

Offset        Specify  the  offset  within  the  frame.  Offset  0  is  the  first 
byte  of  the  SOF,  and  offset  4  is  the  first  byte  of  the 
frame  header.  The  offset  must  be  in  decimal  format. 
Valid  values  for  offset  are  0,  [4-63].  Offset  0  is  a 
special  case  that  can  be  used  to  monitor  the  first  four 
bytes  SOFx  frames.  EOF  cannot  be  monitored. 
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Mask  Specify  the  mask  value  to  be  applied  (AND-ed)  to 
frame  contents. 

ValueList  Specify  up  to  four  values  that  need  to  be  captured 
from  frame  contents.  The  ValueList  can  be  either 
hexadecimal  or  decimal  format. 

SOFx  frames  are  considered  a  special  case.  The  Offset  is  specified 
as  0x0;  valueList  values  are  specified  v/ith: 


0 

SOFf 

1 

SOFcl 

2 

SOFil 

3 

SOFnl 

4 

SOFi2 

5 

SOFn2 

6 

SOFiS 

7 

SOFnS 

alias  Specify  a  name  for  this  monitor.  This  string  truncates  to  a 

maximum  of  1 0  characters.  It  might  be  surrounded  by  quotation 
marks  in  order  to  include  spaces.  This  operand  is  optional. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  add  a  filter-based  monitor  for  all  Extended  Link  Service  requests  (R_CTL=0x22  and  TYPE=0x01 )  to  a 
port: 

switch : admin>  perf addusermonitor  1/4   "4,    Oxff,    0x22;   12,    Oxff,  0x01" 
User  monitor  #0  added 

As  a  special  case,  to  add  a  filter-based  monitor  for  SOFiS  to  a  port: 

switch : admin>  perf addusermonitor  1/4   "0,    Oxff,  6" 
User  monitor  #1  added 

See  also 

perf AddEEMoni tor 
perf AddlPMoni tor 
perf AddReadMoni tor 
perf AddRWMoni tor 
perfAddSCSIMonitor 
perf AddWriteMonitor 
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perfAddWriteMonitor 

Adds  a  filter-based  performance  monitor  for  the  SCSI  write  command. 

Synopsis 

perf  addwritemonitor  [slotnuiaber/]  portnuiaber  [alias] 

Availability 

admin 


NOTE:    This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  define  filter-based  monitors  to  count  the  number  of  SCSI  FCP  write  commands  in 
Fibre  Channel  frames.  Only  frames  transmitted  are  counted. 

After  a  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  filter-based  performance  monitors.  The  optional  user-defined  alias 
also  is  displayed,  if  one  was  specified.  All  valid  monitor  numbers  and  user-defined  aliases  can  be 
retrieved  with  the  perf  ShowFilterMonitor  command. 

The  maximum  number  of  filters  is  eight  per  port,  including  user-defined  filters,  read  filters,  write  filters, 
read/write  filters,  SCSI  frame  monitor,  and  IP  frame  monitor. 


Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

alias  Specify  a  name  for  this  monitor.  This  string  truncates  to  a  maximum  of  1 0 

characters.  It  might  be  surrounded  by  quotation  marks,  in  order  to 
include  spaces.  This  operand  is  optional.  The  default  alias  is 

SCSI_Write. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  add  a  SCSI  Write  command  monitor  to  a  port: 

switch : adinin>  perf addwritemonitor  2/4  "SCSI_W" 
SCSI  Write  filter  monitor  #0  added 
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See  also 

perf AddEEMonitor 
perf AddlPMonitor 
perf AddReadMoni tor 
p e r f AddRWMon i t o r 
perfAddSCSIMonitor 
perf AddUserMoni tor 
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perfCfgClear 

Clears  the  previously  saved  performance  monitoring  configuration  settings  from  nonvolatile  memory. 

Synopsis 


perf cf gclear 


Availability 

admin 


NOTE:    This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  clear  the  previously  saved  end-to-end  and  filter  configuration  settings  of  performance 
monitoring  from  nonvolatile  memory. 

Operands 

none 

Examples 

To  clear  the  performance  monitoring  information  from  nonvolatile  memory: 

switch : adinin>  perfcfgclear 

This  will  clear  Performance  Monitoring  settings  in  FLASH. 

The  RAM  settings  won't  change.  Do  you  want  to  continue?   (yes,  y,  no,  n) : 
[no]  y 

Please  wait  . . . 

Performance  Monitoring  configuration  cleared  from  FLASH. 

See  also 

perf CfgRes tore 
perf Cf gSave 
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perfCfg  Restore 

Restores  performance  monitoring  configuration  settings  from  nonvolatile  memory. 

Synopsis 

perf cf grestore 

Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  restore  the  performance  monitoring  configuration  information  from  nonvolatile 
memory.  This  does  not  restore  the  information  cleared  using  the  perfCfgClear  command;  rather,  it 
restores  the  configuration  on  nonvolatile  memory.  Any  configuration  changes  that  were  not  saved  are  lost 
using  the  perf  Cf  gRestore  command. 

Operands 

none 

Examples 

To  restore  the  performance  monitoring  configuration  information  from  nonvolatile  memory: 


switch :  ac3min>  perf  cf  grestore 

This  will  overwrite  current  Performance  Monitoring 

settings 

in  RAM.   Do  you  want  to  continue?    (yes,   y,   no,   n) : 

[no]  y 

Please  wait  . . . 

Performance  monitoring  configuration  restored  from 

FLASH . 

See  also 

perf Cf gClear 
perf Cf gSave 
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perfCfgSave 

Saves  performance  monitoring  configuration  settings  to  nonvolatile  memory. 

Synopsis 

perf cf gsave 

Availability 

admin 


NOTE:    This  command  requires  a  Performance  Monitor  license. 


Description 

Use  tfiis  command  to  save  the  current  end-to-end  and  filter  configuration  settings  of  performance 
monitoring  into  nonvolatile  memory.  This  enables  the  performance  monitoring  configuration  to  be  saved 
across  pov/er  cycles. 

Operands 

none 

Examples 

To  save  the  current  performance  monitoring  configuration  to  firmv/are: 

switch :  adinin>  perf  cf  gsave 

This  will  overwrite  previously  saved  Performance  Monitoring 
settings  in  FLASH.  Do  you  want  to  continue?    (yes,  y,   no,   n) :    [no]  y 
Please  wait  . . . 

Performance  monitoring  configuration  saved  in  FLASH. 


See  also 

perf Cf gClear 
perf CfgRes tore 
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perfClearEEMonitor 


Clears  statistics  counters  of  an  end-to-end  performance  monitors. 

Synopsis 

perf cleareemonitor    [slotnumber/] portnumber  [monitorld] 

Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license. 
This  command  is  deprecated;  use  perfMonitorClear  instead. 


Description 

Use  this  command  to  clear  statistics  counters  for  all  end-to-end  performance  monitors  on  a  port,  or  an 
end-to-end  monitor  associated  with  a  specific  monitorld. 

Issuing  portStatsClear  on  a  port  also  results  in  all  end-to-end  monitors  clearing. 

Operands 

This  command  has  the  following  operands: 

slotnumber       For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber      Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

monitorld        Specify  the  monitor  number  to  clear.  Monitor  numbers  are  defined  when 
created  and  can  be  displayed  using  perf  ShowEEMonitor.  This 
operand  is  optional.  If  not  specified,  all  monitor  counters  on  the  port  are 
cleared. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  clear  statistics  counters  for  an  end-to-end  monitor: 

switch : admin>  perf cleareemonitor  1/2  5 
End-to-End  monitor  number  5  counters  are  cleared 

switch : admin>  perf cleareemonitor  1/2 

This  will  clear  ALL  EE  monitors'   counters  on  port  2,   continue?    (yes,  y, 
no,   n) : 

[no]  y 
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See  also 

perf AddEEMonitor 
perf ShowEEMonitor 
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perfClearFilterMonitor 


Clears  statistics  counters  of  a  filter-based  performance  monitors. 

Synopsis 

perf clearf iltermonitor   [slotnumber/] portnumber  [monitorld] 

Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license. 
This  command  is  deprecated;  use  perfMonitorClear  instead. 


Description 

Use  this  command  to  clear  statistics  counters  for  all  filter-based  performance  monitors  on  a  port,  or  a 
filter-based  monitor  associated  with  a  specific  monitorld. 

Issuing  portStatsClear  on  a  port  also  results  in  all  filter-based  monitors  clearing. 

Operands 

This  command  has  the  following  operands: 

slotnumber       For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber      Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

monitorld        Specify  the  monitor  number  to  clear.  Monitor  numbers  are  defined  when 
created  and  can  be  displayed  using  perf  ShowEEMonitor.  This 
operand  is  optional.  If  not  specified,  all  monitor  counters  on  the  port  are 
cleared. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  clear  statistics  counters  for  a  filter-based  monitor: 

switch : admin>  perf clearf iltermonitor  1/2  4 
Filter-based  monitor  number  4  counters  are  cleared 

switch : admin>  perf clearf iltermonitor  1/2 

This  will  clear  ALL  filter-based  monitors'  counters  on  port  2,  continue? 
(yes,  Y 

,   no,   n) :    [no]  y 


388   Fabric  OS  commands 


See  also 

perf AddUserMonitor 
perf ShowFilterMonitor 
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perfClrAlpaCrc 

Clears  the  CRC  error  count  associated  with  a  port  and  arbitrated  loop  physical  address  (AL  PA). 

Synopsis 


perf clralpacrc    [slotnumber/] portnumber  [ALPA] 


Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  clear  a  specific  CRC  error  counter  associated  with  a  specific  port  and  AL_PA,  or  all 
such  counters  on  a  port. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

ALPA  Specify  the  AL_PA  address  if  you  want  to  clear  the  CRC  error  counter  for 

a  particular  device.  This  operand  is  optional;  if  omitted,  this  command 
clears  the  counters  for  all  devices  attached  to  the  specified  port. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  clear  the  CRC  count  on  a  particular  AL  PA  on  a  port  and  then  clear  the  CRC  count  for  all  AL_PAs  on  a 
port: 

switch : admin>  perf clralpacrc  2/15  0x59 

CRC  error  count  at  ALPA  0x59  on  port  31  is  cleared. 

switch : admin>  perf clralpacrc  2/15 
This  will  clear  all  ALPA  CRC  Counts  on  port  31 
Do  you  want  to  continue?    (yes,   y,   no,   n)  y 
Please  wait  . . . 

All  alpa  CRC  counts  are  cleared  on  port  31. 

See  also 

perf ShowAlpaCrc 
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perfDelEEMonitor 


Deletes  one  or  all  end-to-end  performance  monitors  from  a  port. 

Synopsis 

perf deleemonitor  [slotnumber/] portnumber  [monitorld] 

Availability 

admin 


NOTE:    This  command  requires  a  Performance  Monitor  license. 


Description 

Use  tfiis  command  to  delete  an  end-to-end  performance  monitor  from  a  port,  or  all  such  monitors 
associated  with  a  port. 

Operands 

This  command  has  the  following  operands: 

slotnumber       For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber      Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

monitorld        Specify  the  monitor  number  to  delete.  Monitor  numbers  are  defined 

when  created  and  can  be  displayed  using  perf  ShowEEMonitor.  This 
operand  is  optional.  If  not  specified,  all  monitor  counters  on  the  port  are 
deleted. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  delete  an  end-to-end  monitor  on  a  port,  or  all  such  monitors: 

switch :  adinin>  perf  deleemonitor  7/2  5 
End-to-End  monitor  number  5  deleted 

switch : admin>  perf deleemonitor  7/2 

This  will  remove  ALL  EE  monitors  on  port  2,   continue?    (yes,   y,   no,   n) : 
[no]  y 

See  also 

perf AddEEMoni tor 
perf ShowEEMonitor 


Fabric  OS  5.0.0  command  reference  guide  391 


perfDelFilterMonitor 


Deletes  one  or  all  filter-based  performance  monitors  from  a  port. 

Synopsis 

perf delf iltermonitor  [slotnumber/]  portnumber  [monitorid] 

Availability 

admin 


'=2^  NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  tfiis  command  to  delete  a  filter-based  performance  monitor  from  a  port,  or  all  such  monitors 
associated  with  a  port. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

monitorid  Specify  the  monitor  number  to  delete.  Monitor  numbers  are  defined 

when  created  and  can  be  displayed  using  perf  ShowEEMonitor.  This 
operand  is  optional.  If  not  specified,  all  monitor  counters  on  the  port  are 
deleted. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  delete  filter  monitor  4  from  a  port,  and  then  all  filter  monitors  from  the  port: 

switch : admin>  perf delf iltermonitor  2/3  4 

The  specified  filter-based  monitor  is  deleted. 

switch : admin>  perf delf iltermonitor  2/3 

This  will  remove  ALL  monitors  on  port  19,   continue?    (yes,  y,   no,   n) : 
[no]  y 

See  also 

perf AddUserMoni tor 
perf ShowFilterMonitor 
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perfHelp 

Displays  performance  monitoring  help  information. 

Synopsis 

perf help 

Availability 

all  users 


NOTE:    This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  display  the  available  performance  monitoring  help  commands. 

Operands 

none 

Examples 

To  display  commands  related  to  performance  monitoring: 


switch :  ac3inin>  perf  help 

perf Cf gSave 

Save  Performance  configuration  to  FLASH 

perf CfgRes tore 
FLASH 

Restore  Performance  configuration  from 

perf Cf gClear 

Clear  Performance  settings  from  FLASH 

perf ClrAlpaCrc 

Clear  ALPA  device ' s  CRC  count 

perf ShowAlpaCrc 

Get  ALPA  CRC  count  by  port  and  ALPA 

perf AddEEMoni tor 

Add  end-to-end  monitor  to  a  port 

perf DelEEMoni tor 

Delete  an  end-to-end  monitor  on  port 

perf ClearEEMoni tor 
on  a  port 

Clear  an  end-to-end  monitors '  counters 

perf ShowEEMoni tor 

Show  user-defined  end-to-end  monitors 

perf SetPortEEMask 

Set  overall  mask  for  E-to-E  monitors 

perf ShowPortEEMask 

Show  the  current  end- to -end  mask 

perf AddUserMoni tor 

Add  filter-based  monitor 

perf AddReadMoni tor 

Add  filter-based  monitor  -  SCSI  Read 

perf AddWriteMoni tor 

Add  filter-based  monitor  -  SCSI  Write 

perf AddRWMoni tor 

Add  monitor  -  SCSI  Read  and  Write 

perfAddSCSIMonitor 

Add  monitor  for  SCSI  frame  count 

perf AddlPMoni tor 

Add  monitor  for  IP  traffic  frame  count 

perf DelFilterMonitor 

Delete  filter-based  monitor 

perf ClearFilterMoni tor 
a  port 

Clear  filter-based  monitors '  counters  on 

perf ShowFilterMonitor 

Show  filter-based  monitors 
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perfMonitorClear 


Clears  counters  of  end-to-end,  filter-based,  and  ISL  performance  monitors  on  a  port. 

Synopsis 

perfmonitorclear  --class  monitor_class   [slotnumber/] portnumber  [monitorld] 

Availability 

admin 

Description 

Use  tfiis  command  to  clear  statistics  counters  for  different  classes  of  monitor.  Monitor  classes  include 
end-to-end  monitors  (EE),  filter-based  monitors  (FLT),  and  ISL  monitors  (ISL). 

Issuing  portStatsClear  command  on  a  port  results  in  all  end-to-end  and  filter-based  monitors  being 
cleared  for  all  the  ports  in  the  same  quad. 

Operands 

This  operands  are  as  follows: 

—class  The  monitor  class,  which  can  be  one  of  EE  (end-to-end),  FLT  (filter-based), 

or  ISL  (inter-switch  link).  This  operand  is  required. 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

monitorld  Specifies  the  monitor  number  to  clear.  Monitor  numbers  are  defined  are 

created,  and  can  be  displayed  using  perfMonitorShow.  This  operand 
is  optional;  if  omitted,  this  command  clears  all  monitor  counters  of  the 
appropriate  monitor_class  on  the  port.  This  operand  does  not  apply 
to  ISL  monitors. 

Examples 

To  clear  statistics  counters  for  an  end-to-end  monitor: 

switch : admin>  perfMonitorClear  1/2  5 

End-to-End  monitor  nuitiber  5  counters  are  cleared 

switch : admin>  perfMonitorClear  1/2 

This  will  clear  ALL  EE  monitors'   counters  on  port  2,  continue? 
(yes,   Y,   no,   n) :    [no]  y 

To  clear  statistics  counters  for  a  filter-based  monitor: 

switch : admin>  perfMonitorClear  --class  FLT  1/2  4 
Filter-based  monitor  number  4  counters  are  cleared 


switch : admin>  perfMonitorClear  --class  FLT  1/2 

This  will  clear  ALL  filter-based  monitors'  counters  on  port  2,  continue? 
(yes,  y,   no,   y) :    [no]  y 
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To  Clear  statistics  counters  for  an  ISL  monitor: 

switch : adinin>  perfMonitorClear  --class  ISL  1 

This  will  clear  ISL  monitor  on  port  1,   continue?    (yes,  y,  no,  n) :    [no]  y 

See  also 

perf AddEEMonitor 
perf AddlPMonitor 
perf AddReadMoni tor 
perf AddRWMoni tor 
perf AddSCSIMoni tor 
perf AddUserMoni tor 
perf AddWriteMonitor 
perf Monitor Show 
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perfMonitorShow 


Displays  end-to-end,  filter-based,  and  ISL  monitors  on  a  port. 

Synopsis 

perfmonitorshow  --class  inonitor_class   [slotnumber/]  portnumber  [interval] 

Availability 

all  users 

Description 

Use  this  command  to  display  previously  created  monitors  on  a  port.  Monitor  classes  include  end-to-end 
monitors  (EE),  filter-based  monitors  (FLT),  and  ISL  monitors  (ISL). 

ISL  monitors  are  automatically  activated  on  E  Ports  (not  including  trunk  slaves).  End-to-end  monitors  are 
created  using  perf  AddEEMonitor.  Filter-based  monitors  are  created  using  perf  AddlPMonitor, 
perf AddReadMonitor,  perf AddRWMoni tor,  perf AddSCSIMonitor,  perf AddUserMonitor,  or 
perf AddWriteMonitor. 

For  end-to-end  monitors,  this  command  displays  (if  no  interval  operand  is  specified): 

Key  The  monitor  number 

SID  Sending  ID 

DID  Destination  ID 

Ov/ner_app  Telnet  or  Web  Tools 

Ov/ner_ip_addr  The  IP  address  of  the  originator  that  created  the  EE  monitor 

Tx  count  Number  of  FC  words  transmitted 

Rx_count  Number  of  FC  words  received 

Crc_count  Number  of  frames  with  CRC  errors 

If  you  do  not  specify  a  value  for  the  interval  operand,  this  command  displays  end-to-end  monitor 
information  and  a  cumulative  count  of  the  traffic  detected  by  the  monitor.  If  you  specify  a  value  for  the 
interval  operand,  this  command  displays  a  snapshot  of  the  traffic  at  the  specified  interval. 

For  filter-based  monitors,  this  command  can  display  (if  no  interval  operand  is  specified)  the  following: 

Key  The  monitor  number 

Alias  The  monitor  alias  name 

Owner_app  Telnet  or  Web  Tools 

Owner_ip_addr  The  IP  address  of  the  originator  that  created  the  filter  monitor 

Frame_count  Cumulative  64-bit  frame  count 

If  you  do  not  specify  a  value  for  the  interval  operand,  this  command  displays  a  cumulative  count  of  the 
traffic  detected  by  the  monitor.  If  you  specify  a  value  for  the  interval  operand,  this  command  displays 
a  snapshot  of  the  traffic  at  the  specified  interval. 

For  ISL  monitors,  the  command  displays: 

Tx_count  64-bit  cumulative  ISL  transmit  count  for  the  whole  ISL 

Num_ports  Number  of  ports  in  this  ISL 

Num  domains  Total  number  of  domains  being  monitored 

Domain  count  64-bit  cumulative  transmit  counter  for  each  individual  domain 
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Operands 


The  operands  are  as  follows: 

class  The  monitor  class,  which  can  be  one  of  EE  (end-to-end),  FLT  (filter-based), 

or  ISL  (inter-switch  link).  This  operand  is  required. 

slotnumber       For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber      Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

interval  Specifies  an  interval  in  (5  or  more)  seconds.  In  the  case  of  end-to-end 

monitor,  the  Tx  and  Rx  counts  are  in  the  unit  of  byte  when  this  operand  is 
specified.  This  operand  is  optional. 


Examples 


To  display  end-to-end  monitor  on  a  port  at  an  interval  of  every  6  seconds: 


switch : 
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perfMonitorShow 
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To  display  EE  monitors  on  a  port: 
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Switch : admin>  per f MonitorShow  --class  EE  4/5 

There  are  7  end-to-end  monitor (s)   defined  on  port  53. 

KEY  SID  DID  OWNER_APP         OWNER_I  P_ADDR  TX_COUNT  RX_COUNT  CRC_COUNT 


0  0x58e0f  Oxll82ef 
0x0000000000000000 


TELNET 


N/A 


0x0000000000000000  0x0000000000000000 


0  0x21300  0x21dda  TELNET 
0x0000000000000000 

1  0x21300  Ox21ddc  TELNET 
0x0000000000000000 

2  0x21300  Ox21deO  TELNET 
0x0000000000000000 

3  0x21300  Ox21del  TELNET 
0x0000000000000000 

4  0x21300  Ox21de2  TELNET 
0x0000000000000000 


5  0x11000  0x21fd6 
0x0000000000000000 


6  0x11000  0x21fe0 
0x0000000000000000 


WEB  TOOLS 


WEB_TOOLS 


N/A 
N/A 
N/A 
N/A 


0x00000004d0ba9915  0x0000000067229e65 

0x00000004d0baa754  0x0000000067229e65 

0x00000004d0bab3a5  0x0000000067229e87 

0x00000004d0bacle4  0x0000000067229e87 


N/A  0x00000004d0bad086  0x0000000067229e87 

192.168.169.40  0x00000004d0bade54  0x0000000067229e87 
192.168.169.40     0x00000004d0baed41  0x0000000067229e98 


To  display  filter-based  monitor  on  a  port  at  an  interval  of  every  6  seconds: 


switch : adinin>  perfMonitorShow  --class  FLT  2/5  6 
perfmonitorshow  21,  6 

0  1  2  3  4  5  6 

#Frames     #Frames     #Frames     #Frames     #Fraities     #Frames  #Frames 
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To  display  filter  monitor  information  on  a  port: 


switch : admin>  perf MonitorShow  --class  FLT  2/5 

There  are  7 

filter-based 

monitors  defined  on 

port  21. 

KEY 

ALIAS 

OWNER_APP 

OWNER_IP_ADDR 

FRAME_C01INT 

0 

SCSI_Frame  TELNET 

N/A 

0x00000000002c2229 

1 

SCSI_WR 

TELNET 

N/A 

0x000000000000464a 

2 

SCSI_RW 

TELNET 

N/A 

OxOOOOOOOOOOOOfdSc 

3 

SCSI_RW 

WEB_TOOLS 

192.168.169.40 

0x0000000000007ba3 

4 

SCSI_RW 

WEB_TOOLS 

192 . 168 . 169 . 190 

0x0000000000004f Oe 

5 

SCSI_RD 

WEB_TOOLS 

192.168.169.40 

0x0000000000002208 

6 

SCSI_WR 

WEB_TOOLS 

192.168.169.40 

0x000000000000033a 

To  display 

ISL  monitor 

information  on  a  port: 

switch : admin>  perf MonitorShow  --class  ISL  1/1 
Total  transmit  count  for  this  ISL:  1462326 
Number  of  destination  domains  monitored:  3 
Number  of  ports  in  this  ISL:  2 

Domain     97:  110379  Domain  98:  13965 

Domain     99:  1337982 


See  also 

perf ShowEEMoni tor 
perf ShowFilterMonitor 
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perfSetPortEEMask 


Sets  overall  mask  for  end-to-end  (EE)  performance  monitors. 


Synopsis 


perf setporteemask  [slotnumber/] portnumber  TxSIDMsk  TxDIDMsk  RxSIDMsk 
RxDIDMsk 


Availability 


admin 


'^^^  NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  set  the  mask  for  the  EE  performance  monitors  of  a  port.  This  command  enables  a 
user  to  selectively  choose  the  kind  of  Fibre  Channel  frames  in  which  the  number  of  v^ords  are  to  be 
counted.  On  setting  the  EE  mask  on  a  port,  all  existing  EE  monitors  on  that  port  are  deleted. 

This  command  controls  all  three  address  fields  (domain  ID,  area  ID,  and  AL_PA  ID)  of  both  the  source  ID 
and  destination  ID,  which  can  be  used  to  trigger  the  monitor. 

When  a  mask  is  set  (Oxff),  the  corresponding  field  will  be  used  to  trigger  the  monitor.  If  the  mask  is  unset 
(0x00),  the  corresponding  field  will  be  ignored. 

There  is  only  one  EE  mask  per  port.  The  mask  is  applied  to  all  eight  EE  monitors  available  on  a  port.  The 
default  EE  mask  value  upon  power-on  is  already  set.  When  ISL  monitoring  is  enabled,  EE  mask  on  E_Ports 
are  controlled  automatically  and  existing  mask  values  for  E_Ports  are  over-written. 


Operands 


This  command  has  the  following  operands: 
slotnumber 


portnumber 


TxSIDMsk 


TxDIDMsk 


For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 
relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

Specify  the  source  ID  mask  in  dd;aa;pp  format,  with  quotation  marks, , 
where  : 

dd  Is  the  domain  ID  mask 

aa  Is  the  area  ID  mask 

pp  Is  AL_PA  ID  mask 

Specify  the  source  ID  mask  in  dd:aa  :pp  format,  with  quotation  marks, , 
where  :dd  is  the  domain  ID  mask,  aa  is  the  area  ID  mask,  and  pp  is 
AL_PA  ID  mask. 

Specify  the  following  values  to  turn  on  or  off  a  specific  field: 

00  Specifies  that  the  field  does  not  trigger  EE  monitors. 

ff  Specifies  that  the  field  does  triggers  EE  monitors. 

Specify  the  destination  ID  mask  in  dd.-aa  .-pp  format.  Quotation  marks 
are  optional.  TxDIDMsk  represents  transmitting  destination  ID  mask.  This 
operand  is  required. 
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RxSIDMsk  Specify  the  source  ID  mask  in  dd:aa:pp  format.  Quotation  marks  are 

optional.  RxSIDMsk  represents  receiving  source  ID  mask.  This  operand  is 
required. 

RxDIDMsk  Specify  the  destination  ID  mask  in  dd.-aa  .-pp  format.  Quotation  marks 

are  optional.  RxDIDMsk  represents  receiving  destination  ID  mask.  This 
operand  is  required. 

Qptionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  set  the  overall  mask  for  end-to-end  monitors  on  a  port: 

switch :adinin>  perf setporteemask  1/6   "00:00:00"    "ff:ff:ff"  "00:00:ff" 
"ff :00:00" 

Changing  EE  mask  for  this  port  will  cause  ALL  EE  monitors  on  this  port 
to  be  deleted. 

continue?    (yes,   y,   no,   n) :    [no]  y 

The  EE  mask  on  port  6  is  set  and  EE  Monitors  on  this  port  are  deleted 

See  also 

perf AddEEMoni tor 
perf ShowEEMoni tor 
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perfShowAlpaCrc 

Displays  the  CRC  error  count  by  port  or  by  arbitrated  loop  physical  address  (AL_PA). 

Synopsis 

perf showalpacrc    [slotnumber/] portnumber  [ALPA] 

Availability 

all  users 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  display  the  CRC  error  count  of  one  or  all  devices  attached  to  a  port.  If  the  AL  PA 
operand  is  specified,  only  the  CRC  count  for  that  AL_PA  device  is  displayed.  If  the  AL  PA  operand  is  not 
specified,  the  CRC  count  for  all  the  AL  PA  devices  on  a  specified  port  are  displayed. 

CRC  count  is  a  64-bit  counter.  When  the  count  is  over  32  bits,  the  CRC  count  value  is  displayed  in 
hexadecimal;  otherv/ise,  CRC  count  is  displayed  in  decimal  format. 

Operands 

This  command  has  the  follov/ing  operands: 

slotnumber       For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  follov^ed  by  a  slash  (/). 

portnumber       Specifies  the  number  of  the  port  on  v/hich  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

ALPA  Specify  the  AL  PA  address  if  you  want  to  get  the  CRC  errors  for  a 

particular  device.  This  operand  is  optional;  if  omitted,  this  command 
displays  CRC  error  counts  for  all  devices  attached  to  the  specified  port. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  display  the  CRC  error  count  for  all  AL_PA  devices  on  a  port: 

switch : admin>  perf showalpacrc  2/4 
ALPA  CRC_ERROR_COUNT 


0x01  0 

See  also 

perf ClrAlpaCrc 
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perfShowEEMonitor 


Displays  end-to-end  performance  monitor  information  on  a  port. 

Synopsis 

perf  showeemonitor  [slotnumber/]  portnuiaber  [interval] 

Availability 

all  users 


NOTE:  This  command  requires  a  Performance  Monitor  license. 
This  command  is  deprecated;  use  perfMonitorShow  instead. 


Description 

Use  this  command  to  display  end-to-end  monitor  information  on  a  port. 
Refer  to  perfMonitorShow  for  details  regarding  this  command's  output. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number 

of  the  port  on  which  the  monitor  is  to  be  added,  followed  by  a 
slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be 

added,  relative  to  its  slot  for  bladed  systems.  Use  switchShow 
for  a  list  of  valid  ports. 

interval  Specify  an  interval,  in  seconds  (5  or  more).  Tx  and  Rx  counts  are 

in  the  unit  of  byte  when  this  operand  is  specified.  This  operand 
is  optional. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 


Fabric  OS  5.0.0  command  reference  guide  403 


Examples 

To  display  end-to-end  monitor  frame  traffic  on  a  port  at  an  interval  of  every  6  seconds: 


switch :  adinin>  per f  showeemonitor  4/5  6 
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To  display  EE  monitors  on  a  port: 


switch : adinin>  perf showeemonitor  4/5 

There  are  7  end-to-end 

monitor (s)  defined 

on  port  53 . 

KEY           SID  DID 

OWNER_APP 

OWNER_IP_ADDR 

TX_COUNT 

RX_COUNT 

CRC_COUNT 

0       0x21300  0x21dda 

TELNET 

N/A 

0x00000004d0ba9915 

0x0000000067229e65 

0x0000000000000000 

1       0x21300  0x21ddc 

TELNET 

N/A 

0x00000004d0baa754 

0x0000000067229e65 

0x0000000000000000 

2       0x21300  0x21de0 

TELNET 

N/A 

0x00000004d0bab3a5 

0x0000000067229e87 

0x0000000000000000 

3       0x21300  0x21del 

TELNET 

N/A 

0x00000004d0bacle4 

0x0000000067229e87 

0x0000000000000000 

4       0x21300  0x21de2 

TELNET 

N/A 

0x00000004d0bad086 

0x0000000067229e87 

0x0000000000000000 

5       0x11000  0x21fd6 

WEB_TOOLS 

192 . 168 . 169 . 

,40 

0x00000004d0bade54 

0x0000000067229e87 

0x0000000000000000 

6       0x11000  0x21fe0 

WEB_TOOLS 

192.168.169. 

,40 

0x00000004d0baed41 

0x0000000067229e98 

0x0000000000000000 

See  also 

perf AddEEMoni tor 
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perfShowFilterMonitor 


Displays  filter-based  performance  monitor  information  for  a  port. 

Synopsis 

perf showf iltermonitor  [slotnumber/] portnumber  [interval] 

Availability 

all  users 


r»'>\6. 

NOTE:  This  command  requires  a  Performance  Monitor  license. 
This  command  is  deprecated;  use  perfMonitorShow  instead. 


Description 

Use  this  command  to  display  all  the  filter-based  monitors  defined  on  the  specified  port  and  the  traffic  count 
values. 

Refer  to  perfMonitorShow  for  details  regarding  this  command's  output. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number 

of  the  port  on  which  the  monitor  is  to  be  added,  followed  by  a 
slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be 

added,  relative  to  its  slot  for  bladed  systems.  Use  switchshow 
for  a  list  of  valid  ports. 

interval  Specify  an  interval,  in  seconds  (5  or  more).  This  operand  is 

optional. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  display  filter  monitor  traffic  on  a  port  at  an  interval  of  every  6  seconds: 


switch 

admin>  perf showf iltermonitor 

2/5  6 

perf showf iltermonitor  21, 

6 

0 

1  2 

3 

4 

5 

6 

#Frames       #CMDs  #CMDs 

#Frames 

#Frames 

#CMDs 

#CMDs 

0 

0  0 

0 

0 

0 

0 

26k 

187  681 

682 

682 

494 

187 

26k 

177  711 

710 

710 

534 

176 

26k 

184  734 

734 

734 

550 

184 

26k 

182  649 

649 

649 

467 

182 

26k 

188  754 

755 

755 

567 

184 

26k 

183  716 

716 

717 

534 

183 

26k 

167  657 

656 

655 

488 

167 

26k 

179  749 

749 

749 

570 

179 

(continued  on  next  page) 
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26k 

164 

752 

752 

752 

588 

164 

2  6k 

190 

700 

700 

700 

510 

190 

2  6k 

181 

701 

701 

701 

520 

181 

26k 

200 

750 

750 

751 

550 

201 

26k 

180 

692 

692 

691 

512 

179 

2  6k 

179 

696 

696 

695 

517 

179 

2  6k 

187 

720 

720 

720 

533 

187 

26k 

200 

722 

722 

722 

522 

200 

2  6k 

204 

717 

717 

717 

513 

204 

To  display  filter  monitor  information  on  a  port: 


switch : admin>  perf showf iltermonitor  2/5 

There  are  7  filter-based  monitors  defined  on  port  21. 


KEY 

ALIAS 

OWNER_APP 

OWNER 

_IP_ADDR 

FRAME_COUNT 

0 

SCSI. 

_Fraitie 

TELNET 

N/A 

0x00000000002c2229 

1 

SCSI 

_WR 

TELNET 

N/A 

0x000000000000464a 

2 

SCSI. 

_RW 

TELNET 

N/A 

OxOOOOOOOOOOOOfdSc 

3 

SCSI 

_RW 

WEB_TOOLS 

192 

.168.169 

.40 

0x0000000000007ba3 

4 

SCSI. 

_RW 

WEB_TOOLS 

192  . 

168.169. 

190 

0x0000000000004f Oe 

5 

SCSI 

_RD 

WEB_TOOLS 

192 

.158.169 

.40 

0x0000000000002208 

6 

SCSI 

_WR 

WEB_TOOLS 

192 

.158.169 

.40 

0x000000000000033a 

NOTE:  If  you  do  not  specify  an  interval,  the  filter-based  monitor  frame  count  is  displayed  in  64-bit  format 
and  is  cumulative. 


See  also 

perf AddEEMoni tor 
perf AddlPMoni tor 
perf AddReadMoni tor 
perf AddRWMoni tor 
perfAddSCSIMonitor 
perf AddUserMoni tor 
perf AddWriteMonitor 
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perfShowPortEEMask 

Displays  the  current  address  mask  for  end-to-end  performance  monitors  on  a  port. 

Synopsis 

perf  showporteemask  [  slotnumber/]  portnuiaber 

Availability 

all  users 


NOTE:    This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  display  the  current  mask  shared  across  all  end-to-end  (EE)  performance  monitors  of  a 
port.  There  are  only  two  commands  that  can  modify  the  value  of  the  EE  mask:  perf  SetPortEEMask 
and  perf Cf gRestore. 

The  end-to-end  mask  has  1 2  fields: 


TxSID  Domain: 

on 

TxSID  Area: 

on 

TxSID  ALPA: 

on 

TxDID  Domain: 

on 

TxDID  Area: 

on 

TxDID  ALPA: 

on 

RxSID  Domain: 

on 

RxSID  Area: 

on 

RxSID  ALPA: 

on 

RxDID  Domain: 

on 

RxDID  Area: 

on 

RxDID  ALPA: 

on 

The  fields  that  are  marked  on  are  used  to  trigger  end-to-end  monitors.  The  default  value  of  the  EE  mask  is 
all  fields  set  to  on. 

Operands 

This  command  has  the  follov/ing  operand: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be 

added,  relative  to  its  slot  for  bladed  systems.  Use  switchshow  for  a 
list  of  valid  ports. 
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Examples 

To  display  the  end-to-end  mask  on  a  port: 

switch : admin>  perf showporteemask  2/4 

The  EE  mask  onport  20  is  set  by  application  NONE 


TxSID 

Domain : 

on 

TxSID 

Area : 

on 

TxSID 

ALPA: 

on 

TxDID 

Domain : 

on 

TxDID 

Area : 

on 

TxDID 

ALPA: 

on 

RxSID 

Domain : 

on 

RxSID 

Area : 

on 

RxSID 

ALPA: 

on 

RxDID 

Domain : 

on 

RxDID 

Area : 

on 

RxDID 

ALPA: 

on 

See  also 

perf AddEEMoni tor 
perf DelEEMoni tor 
perf SetPortEEMask 
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pkiCreate 

Creates  public  key  infrastructure  (PKI)  objects. 

Synopsis 


pkicreate 

Availability 

admin 

Description 

Use  this  command  in  nonsecure  mode  to  create  PKI  objects: 

•  Switch  private  key  and  CSR 

•  Private  key  pass-phrase 

•  Install  root  certificate 

This  command  does  not  create  the  switch  certificate.  The  switch  certificate  should  be  obtained  offline  from 
Certificate  Authority. 

In  secure  mode,  this  command  exits  with  a  warning  and  does  not  create  PKI  objects. 

Operands 

none 

Examples 

To  create  PKI  objects  in  nonsecure  mode: 

switch : admin>  pkicreate 
Installing  Private  Key  and  Csr. . . 
Switch  key  pair  and  CSR  generated. . . 
Installing  Root  Certificate... 

If  run  in  secure  mode,  the  following  error  message  is  displayed: 

switch :admin>  pkicreate 

Warning   ! !   Switch  is  in  secure  mode. 
Cannot  create  new  Pki  Objects.  Exiting... 

See  also 

pkiRemove 
pkiShow 
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pkiRemove 

Remove  existing  public  key  infrastructure  (PKI)  objects. 

Synopsis 


pkiremove 

Availability 

admin 

Description 

Use  this  command  to  remove  PKI  objects  in  nonsecure  mode.  It  removes  sv/itch  private  key,  private  key 
pass-phrase,  CSR,  root  certificate,  and  sv/itch  certificate. 

In  secure  mode,  this  command  displays  a  message  and  does  not  remove  PKI  objects. 

Operands 

none 

Examples 

To  remove  PKI  objects  in  nonsecure  mode: 

switch : admin>  pkiremove 

WARNING ! ! ! 

Removing  Pki  objects  will  impair  the  security  functionality 
of  this  fibre  channel  switch.   If  you  want  secure  mode  enabled, 
you  will  need  to  get  the  switch  certificate  again. 

About  to  remove  Pki  objects. 

ARE  YOU  SURE   (yes,  y,   no,   n) :    [no]  y 

All  PKI  objects  removed. 

If  run  in  secure  mode,  the  follov/ing  error  message  is  displayed: 

switch : admin>  pkiremove 

This  Switch  is  in  secure  mode. 

Removing  Pki  objects  is  not  allowed.   Exiting. . . 

See  also 

pkiCreate 
pkiShow 
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pkiShow 


Displays  existing  public  key  infrastructure  (PKI)  objects. 


Synopsis 

pkishow 

Availability 

all  users 

Description 

Use  this  command  to  display  existence  of  PKI  objects,  such  as  switch  private  key,  private  key  pass-phrase, 
CSR,  root  certificate,  and  switch  certificate. 

Operands 

none 

Examples 

To  view  PKI  objects: 


switch :  adinin>  pkishow 


Passphrase 


Exist 


Private  Key 


Exist 


CSR 


Exist 


Certificate 


Empty 


Root  Certificate 


Exist 


See  also 


pkiCreate 


pkiRemove 
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portAlpaShow 

Displays  the  AL  PAs  of  a  port. 

Synopsis 

portalpashow  [ slotnumber/] portnumber 

Availability 

all  users 


Description 

Use  this  command  to  display  the  AL_PAs  present  in  a  port.  If  the  port  is  not  an  active  L_Port  or  if  it  does  not 
have  any  AL  PA,  this  command  displays  an  error. 


Operands 


This  command  has  the  follov/ing  operands: 

slotnumber  Specify  the  slot  number  for  a  Core  Sv/itch  2/64  or  SAN  Director  2/1  28. 

For  all  other  switches,  this  operand  is  not  required.  The  slot  number  must 
be  follov/ed  by  a  slash  (  /  )  and  the  port  number,  so  that  each  port  is 
represented  by  both  slot  number  (1  through  4  or  7  through  1 0)  and  port 
number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of  1 0  slots. 
Slot  numbers  5  and  6  are  control  processor  cards;  slots  1  through  4  and 
7  through  10  are  port  cards.  On  each  port  card,  there  are  16  ports, 
counted  from  the  bottom,  numbered  0  to  15. 

portnumber  Specify  a  port  number.  Valid  values  for  port  number  vary,  depending  on 

the  switch  type.  This  operand  is  optional. 


Examples 


To  display  the  AL_PAs  of  a  port: 


switch :user>  portalpashow  4/14 
AL_PA      type  AL_PA  type 

0xe2         public  Oxe4  public 


AL  PA 


type 


See  also 

switchShow 
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portBufferShow 


Displays  the  buffer  usage  information  for  a  port  group  or  for  all  port  groups  in  the  switch. 


Synopsis 


portbuf f ershow  [slotnumber/]  [portnumber] 


Availability 

all  users 


Description 

Use  this  command  to  display  the  current  long  distance  buffer  information  for  the  ports  in  a  port  group.  The 
port  group  can  be  specified  by  giving  any  port  number  in  that  group.  If  no  port  is  specified,  then  the  long 
distance  buffer  information  for  all  of  the  port  groups  of  the  switch  is  displayed. 

The  following  long  distance  information  is  displayed: 


User  Port 
Port  Type 

Lx  Mode 


Max/Resv  Buffers 


Buffer  Usage 


Needed  Buffers 


Link  Distance 


Remaining  Buffers 


Displays  the  area  number  of  the  port. 

Displays  as  E  (E_Port),  F  (F_Port),  G  (G_Port),  L  (L_Port),  or  U 
(U_Port)  depending  on  the  port  type. 

Displays  as  LO  when  the  link  is  not  in  long  distance  mode,  LE 
when  the  link  is  up  to  10  Km,  LM  when  the  link  is  up  to  25  Km, 
LI  when  the  link  is  up  to  50  Km,  L2  when  the  link  is  up  to  100 
Km  or  LD  when  the  distance  is  to  be  determined  dynamically. 

Displays  the  count  of  the  maximum  or  reserved  number  of  buffers 
that  are  allocated  to  the  port  based  on  the  estimated  distance 
(configured  by  the  desired_di stance  operand  of  the 
portCf  gLongDistance  command).  If  the  port  is  not 
configured  in  long  distance  mode,  certain  systems  might  reserve 
buffers  for  the  port.  This  field  then  displays  the  number  of  buffers 
reserved  for  the  port. 

Displays  the  actual  number  of  buffers  allocate  to  the  port.  In  LD 
mode,  the  number  is  determined  by  by  the  actual  distance  and 
the  user-specified  desired  distance  (configured  by  the 

desired_distance  operand  of  the 
portCf gLongDistance  command). 

Displays  the  number  of  buffers  that  are  needed  to  utilize  the  port 
at  full  bandwidth  (depending  on  the  port  configuration).  If  the 
number  of  Buffer  Usage  is  less  than  the  number  of  Needed 
Buffers,  the  port  is  operating  in  the  buffer  limited  mode. 

For  LO  (not  in  long  distance  mode),  the  fixed  distance  displays 
based  on  the  port  speed,  for  instance:  1 G  as  10  Km,  2G  as  5 
Km,  and  4G  as  2  Km.  For  the  static  long  distance  modes,  the 
fixed  distance  displays;  for  instance,  LE  as  10  Km,  LM  as  25  Km, 
LI  as  50  Km,  and  L2  as  100  Km.  For  LD  mode,  the  physical 
distance  in  kilometers  displays  as  measured  by  timing  the  return 
trip  of  a  MARK  primitive  that  is  sent  and  then  echoed  back  to  the 
switch.  The  supported  distance  measurement  is  up  to  500  Km. 
Distance  measurement  on  a  link  longer  than  500  Km  might  not 
be  accurate. 

Displays  the  remaining  (unallocated  and  reserved)  buffers  in  a 
port  group. 
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When  there  is  no  connection  to  a  port  or  the  port  is  disabled,  or  the  port  is  not  an  E  Port  some  of  the 
information  in  this  display  is  not  relevant,  such  as  long  distance  mode,  needed  buffers,  and  link  distance. 
In  this  case,  the  irrelevant  fields  display  as  hyphens. 

Operands 

This  command  has  the  follov/ing  operands: 

slotnumber  For  bladed  systems  only,  specifies  the  slot  number  of  the  port  group  to 

display,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  a  port  associated  v/ith  the  port  group  to  display, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports.  This  operand  is  optional;  if  omitted,  this  command  displays  the 
long  distance  buffer  information  for  all  the  port  groups  of  the  switch.  In 
the  case  where  this  command  displays  information  for  all  the  port  groups 
of  the  switch,  a  divider  line  displays  between  the  ports  of  each  port 
group  to  assist  in  readability. 

Examples 

To  display  the  long  distance  information  a  port: 

switch : user>  portbuf f ershow  17 


User     Port       Lx      Max/Resv  Buffer  Needed  Link  Remaining 

Port    Type    Mode    Buffers    Usage    Buffers    Distance  Buffers 


16  -  -  0  -  - 

17  E         LI  -  54  54  50km 

18  -  -  0  -  - 

19  _  _  0  -  -  54 


See  also 

portCfgLongDi stance 
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portCamShow 


Displays  port-based  filter  CAM  utilization. 


Synopsis 


portcamshow  [slotnumber/]  [portnumber] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  filter  CAM  utilization  of  all  ports  or  one  port  specified  at  input. 

The  following  information  is  displayed: 

SID  used  Display  total  number  of  CAM  entries  used  by  this  port.  Note  that  each 

CAM  entry  (either  SID  or  DID  CAM)  can  be  shared  among  ports  in  the 
same  quad. 

DID  used  Display  total  number  of  CAM  entries  used  by  this  port.  Note  that  each 

CAM  entry  (either  SID  or  DID  CAM)  can  be  shared  among  ports  in  the 
same  quad. 

SID  entries  Display  all  existing  source  ID  entries  within  the  CAM  per  quad.  Note  that 

each  CAM  entry  (either  SID  or  DID  CAM)  can  be  shared  among  ports  in 
the  same  quad. 

DID  entries  Display  all  existing  destination  ID  entries  within  the  CAM  per  quad.  Note 

that  each  CAM  entry  (either  SID  or  DID  CAM)  can  be  among  ports  in  the 
same  quad. 

SID  free  Display  the  total  number  of  free  SID  CAM  entries  per  quad. 

DID  free  Display  the  total  number  of  free  DID  CAM  entries  per  quad. 


Operands 


This  command  has  the  following  operands: 

slotnumber         Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director 

2/128.  For  all  other  switches,  this  operand  is  not  required.  The  slot 
number  must  be  followed  by  a  slash  (  /  )  and  the  port  number,  so  that 
each  port  is  represented  by  both  slot  number  (1  through  4  or  7  through 
10)  and  port  number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of  10 
slots.  Slot  numbers  5  and  6  are  control  processor  cards;  slots  1  through 
4  and  7  through  1 0  are  port  cards.  On  each  port  card,  there  are  1 6 
ports,  counted  from  the  bottom,  numbered  0  to  15. 

portnumber         Specify  a  port  number.  Valid  values  for  port  number  vary,  depending 
on  the  switch  type.  This  operand  is  optional. 
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Examples 

To  display  the  filter  CAM  utilization  for  all  ports  on  a  switcfi: 


switch :user>  portcamshow 


Ports  of  Slot  9 


Port 

SID  used 

DID 

0 

0 

0 

1 

0 

0 

2 

0 

0 

3 

0 

0 

4 

0 

0 

5 

0 

0 

5 

0 

0 

7 

0 

0 

8 

0 

0 

9 

0 

0 

10 

0 

0 

11 

1 

1 

12 

0 

0 

13 

0 

0 

14 

0 

0 

15 

18 

2 

used 


Quad  ports    (SID  Free,   DID  Free) 

00-03  (64,  512)  04-07  (54,  512)  08-11  (63,  511)  12-15  (46,  510) 
(output  truncated) 


To  display  the  filter  CAM  utilization  for  a  single  port  on  a  switch: 


switch :user>  portcamshow  3/2 

Area    SID  used    DID  used    SID  entries 

DID  entries 

34           3                  1  350400 

2b2200 

2bl200 

220400 

Quad  ports    (SID  Free,   DID  Free) 

32-35    (61,  511) 

See  also 

switchShow 
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portCfgDefault 


Restores  the  port  configuration  to  default  values. 


Synopsis 

portcf  gdef  ault  [  slotnumber/]  portnuiaber 

Availability 

admin 

Description 

Use  this  command  to  reset  any  special  configuration  values  on  a  port  to  their  factory  defaults.  You  can 
viev/  the  current  port  configuration  using  the  portCf  gShow  command. 


Operands 


This  command  has  the  following  operands: 

slotnumber         Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director 

2/1 28.  For  all  other  switches,  this  operand  is  not  required.  The  slot 
number  must  be  followed  by  a  slash  (  /  )  and  the  port  number,  so  that 
each  port  is  represented  by  both  slot  number  (1  through  4  or  7  through 
10)  and  port  number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of  10 
slots.  Slot  numbers  5  and  6  are  control  processor  cards;  slots  1  through 
4  and  7  through  1 0  are  port  cards.  On  each  port  card,  there  are  1 6 
ports,  counted  from  the  bottom,  numbered  0  to  15. 

portnumber         Specify  a  port  number.  Valid  values  for  port  number  vary,  depending 
on  the  switch  type.  This  operand  is  required. 


Examples 


To  reset  a  port  to  factory  defaults: 


switch  :adinin>  portcf  gdef  ault  1/3 


See  also 


portCfgEPort 
portCfgGPort 
portcf gLongDi stance 
portcf gLPort 

portcf gPers is tentDisable 
portcf gPers is tentEnable 
portcf gShow 
portcf gSpeed 
portcf gTrunkPort 
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portCfgEPort 

Enables  or  disables  a  port  from  becoming  an  E_Port. 

Synopsis 

portcfgeport    [slotnumber/]portnuinber,  mode 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  a  port  from  becoming  an  E_Port.  The  E_Port  capability  is  enabled 
by  default  unless  this  command  is  used  to  disable  it. 

When  a  port  is  configured  as  a  non-E_Port  through  this  command,  an  ISL  connected  to  this  port  is 
segmented.  No  data  traffic  between  two  switches  is  routed  through  this  port.  Fabric  management  data, 
such  as  zoning  information,  are  not  exchanged  through  this  port  either. 

Regardless  of  how  many  E_Ports  are  connected  between  two  switches,  the  maximum  routing  paths  are 
currently  limited  to  1 6  E_Ports. 

Changes  made  by  this  command  are  persistent  across  switch  reboots  or  power  cycles. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specifies  the  slot  number  of  the  port  to  be 

configured,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  to  be  configured,  relative  to  its  slot  for 

bladed  systems.  Use  switchShow  to  display  a  list  of  valid  ports. 

mode  Specify  1  to  enable  the  port  to  become  an  E_Port.  This  is  the  default  port 

state.  Specify  0  to  disable  the  port  from  becoming  an  E  Port. 

Examples 

To  disable  a  port  from  becoming  an  E_Port: 

switch: admin>  portcfgeport  2/3,  0 

To  enable  a  port  to  become  an  E  Port: 

switch : admin>  portcfgeport  1/3,  1 

See  also 

portShow 
switchShow 
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portCfgGPort 

Designates  a  port  as  a  G_Port. 

Synopsis 

portcfggport  [slotnumber/]  portnuraber,  mode 

Availability 

admin 

Description 

Use  this  command  to  designate  a  port  as  a  G_Port.  After  this  is  done,  the  switch  attempts  to  initialize  that 
port  as  an  F  Port  only,  and  does  not  attempt  loop  initialization  (FL_Port)  on  the  port.  A  port  designated  as 
a  G_Port  can  become  an  E  Port. 

Changes  made  by  this  command  are  persistent  across  switch  reboots  or  power  cycles. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  be 

configured,  followed  by  a  slash  (/). 

portnumber  Specify  the  number  of  the  port  to  be  configured,  relative  to  its 

slot  for  bladed  systems.  Use  switchShow  to  display  a  list  of 
valid  ports. 

mode  Specify  a  value  of  1  to  designate  the  port  as  a  G_Port  or  specify 

a  value  of  0  to  remove  the  G_Port  designation  from  the  port.  A 
value  of  0  is  the  default  port  state.  This  operand  is  required. 

Examples 

To  configure  a  port  as  a  locked  G_Port: 

switch:adinin>  portcfggport  1/3,  1 

See  also 

configure 
portCf gLPort 
portShow 
switchShow 
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portCfglSLMode 


Enables  or  disables  ISL  R_RDY  mode  on  a  port. 


Synopsis 

portcf gislmode  [slotnuinber/]portnunLber,  [mode] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  ISL  R  RDY  mode  on  a  port.  If  enabling  ISL  R_RDY  mode  on  a  port, 
make  sure  the  PID  format  is  consistent  across  the  entire  fabric.  Refer  to  the  configure  command  for  more 
information  on  the  core  PID  format. 

ISL  R  RDY  mode  sends  ELP  with  Flow  Control  Mode  02  and  enables  connectivity  with  WAN  gateway 
products.  If  a  port  is  ISL  R_RDY  mode-enabled,  it  can  only  receive  ELP  with  Flow  Control  Mode  02;  ELP 
with  Flow  Control  Mode  01  segments  the  fabric. 

This  mode  cannot  detect  the  PID  format  of  connected  ports.  If  the  PID  formats  for  two  ISL  R_RDY  mode 
ports  are  not  the  same,  zoning  drops  frames. 

This  feature  is  persistent  across  reboots  and  does  not  require  a  license  key. 

Use  the  portCf  gShow  command  to  view  whether  ISL  R_RDY  mode  is  enabled  on  a  port. 


NOTE:  The  portCf  giSLMode  and  portCf  gLongDistance  mode  both  cannot  be  enabled  at  the 
same  time;  otherwise,  fabric  segmentation  occurs. 


Operands 


This  command  has  the  following  operands: 

slotnumber  Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director  2/1  28. 

For  all  other  switches,  this  operand  is  not  required.  The  slot  number  must 
be  followed  by  a  slash  (  /  )  and  the  port  number,  so  that  each  port  is 
represented  by  both  slot  number  (1  through  4  or  7  through  1 0)  and  port 
number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of  1 0  slots. 
Slot  numbers  5  and  6  are  control  processor  cards;  slots  1  through  4  and 
7  through  10  are  port  cards.  On  each  port  card,  there  are  16  ports, 
counted  from  the  bottom,  numbered  0  to  15. 

portnumber  Specify  a  port  number.  Valid  values  for  port  number  vary,  depending  on 

the  switch  type.  This  operand  is  required. 

mode  Specify  1  to  enable  ISL  R_RDY  mode.  Specify  0  to  disable  ISL  R_RDY 

mode.  This  operand  is  required. 
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Examples 

To  enable  ISL  R_RDY  mode  on  a  port: 

switch : adinin>  portcf gislmode  1/3,  1 

ISL  R_RDY  Mode  is  enabled  for  port  3 .  Please  make  sure  the  PID 
formats  are  consistent  across  the  entire  fabric. 

To  disable  ISL  R_RDY  mode  on  a  port: 

switch : admin>  portcf gislmode  1/3,  0 

See  also 

portcf gShow 
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portCfg  Long  Distance 


Configures  a  port  to  support  long-distance  links. 

Synopsis 

portcf glongdistance  [slotnumber/] portnumber  [  distance_level] 
[ vc_translation_link_init]    [ desired_di stance] 

Availability 

admin 


NOTE:   This  command  requires  an  HP  Extended  Fabrics  license. 


Description 

Use  this  command  to  allocate  enough  full-size  frame  buffers  on  a  particular  port  to  support  a  long-distance 
link  up  to  500  km.  The  port  can  only  be  used  as  an  E_Port.  Changes  made  by  this  command  are  persistent 
across  switch  reboots  or  power  cycles. 

The  value  of  distance_level  can  be  one  of  the  following  (the  numerical  value  representing  each 
distance_level  is  shown  in  parentheses): 

LO  (0)  Reconfigure  the  port  to  be  a  regular  switch  port.  A  total  of  20  full-size  frame 

buffers  are  reserved  for  data  traffic,  regardless  of  the  port's  operating  speed. 
Therefore,  the  maximum  supported  link  distance  is  1 0  km,  5  km,  or  2.5  km  for  the 
port  speeds  of  1  Gb/s,  2  Gb/s,  or  4  Gb/s,  respectively. 

L0.5  Level  0.5  (portCf  gShow  displays  the  two-letter  code  as  LM)  long  distance,  up  to 

25  km.  A  total  of  1  2,  25,  or  50  full-size  frame  buffers  are  reserved  for  the  port  at 
speeds  of  1  Gb/ s,  2  Gb/ s,  or  4  Gb/ s,  respectively. 

LI  (1 )  Level  1  long  distance,  up  to  50  km.  A  total  of  25,  50,  or  1 00  full-size  frame 

buffers  are  reserved  for  the  port  at  speeds  of  1  Gb/s,  2  Gb/s,  or  4  Gb/s, 
respectively. 

L2  (2)  Level  2  long  distance,  up  to  100  km.  A  total  of  50,  100,  or  200  full-size  frame 

buffers  are  reserved  for  the  port  at  speeds  of  1  Gb/s,  2  Gb/s,  or  4  Gb/s, 
respectively.  For  previously  released  switches  (Bloom  1 -based),  the  number  of 
frames  buffers  is  limited  to  63. 

LE  (3)  Level  E  mode  is  for  E_Ports  for  distances  beyond  5  km  and  up  to  10  km.  A  total  of 

5,  1 0,  or  20  full-size  frame  buffers  are  reserved  for  the  port  at  speeds  of  1  Gb/s, 
2  Gb/s,  or  4  Gb/s,  respectively.  LE  does  not  require  an  Extended  Fabrics  license. 

LD  Automatic  long-distance  configuration.  The  buffer  credits  for  the  given  E  Port  are 

automatically  configured,  based  on  the  actual  link  distance.  Up  to  a  total  of  250 
full-size  frame  buffers  are  reserved,  depending  upon  the  distance  measured 
during  E_Port  initialization.  If  the  desired  distance  is  provided,  it  is  used  as  the 
upper  limit  to  the  measured  distance.  For  Bloom  1 -based  systems,  the  number  of 
frame  buffers  is  limited  to  63. 

Depending  on  the  switch  platform  and  the  availability  of  frame  buffers  within  the  port  group,  the  LD  mode 
link  can  operate  up  to  distances  of  500  km  at  1  Gb/s,  250  km  at  2  Gb/s,  or  1  25  km  at  4  Gb/s.  On 
some  older  switch  platforms,  the  LD  mode  link  can  operate  up  to  distances  of  200  km  at  1  Gb/s  or  1 00 
km  at  2  Gb/s. 
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A  long-distance  link  also  can  be  configured  to  be  part  of  a  trunk  group  (refer  to  portCf  gTrunkPort). 
Two  or  more  long-distance  links  in  a  port  group  forms  a  trunk  group  when  they  are  configured  for  the 
same  speed,  the  same  distance  level,  and  their  link  distances  are  nearly  equal. 

The  vc_translation_link_init  option  is  used  to  enable  the  long-distance  link  initialization 
sequence. 

desired_distance  is  a  required  parameter  to  configure  a  port  as  an  LD-mode  link.  The  desired 
distance  is  used  as  the  upper  limit  of  the  link  distance  to  calculate  buffer  availability  for  other  ports  in  the 
same  port  group.  When  the  measured  distance  is  more  than  desired_distance,  the 
desired_distance  allocates  buffers.  In  this  case,  the  port  operates  in  degraded  mode  instead  being 
disabled  due  to  insufficient  buffers. 

Pressing  Ctrl-i-D  cancels  the  configuration  update. 

When  a  port  is  configured  to  be  a  long-distance  port,  the  output  of  portShow  and  switchShow 
displays  the  long-distance  level.  In  the  portShow  output,  the  long-distance  level  is  indicated  as  follows: 

•  LO  normal 

•  LE    standard  <=  1 0  km 

•  LM  medium  long  <=  25  km 

•  LI    long  <=  50  km 

•  L2   super  long  <=  1 00  km 

•  LD  auto 

In  the  switchShow  output,  the  long  distance  mode  displays  as  Lx,  where  x  is  the  second  letter  in 
two-letter  distance-level  code  described  earlier;  however,  L0.5  mode  displays  L0.5. 


NOTE:    The  portCf  giSLMode  and  portCf  gLongDistance  mode  cannot  both  be  enabled  at  the 
same  time;  otherwise,  fabric  segmentation  occurs. 

When  some  of  the  ports  in  the  switch  are  configured  as  long-distance  ports,  the  remaining  ports  can  be 
disabled  or  running  in  buffer-limited  mode  due  to  a  lack  of  frame  buffers.  Conversely,  if  a  port  is 
configured  as  a  long-distance  port  and  there  are  not  enough  frame  buffers  remaining,  the  port  does  not 
initialize. 


Operands 

This  command  has  the  following  operands: 

slotnumber  Specifies  the  slot  number,  for  bladed  systems  only.  The  slot 

number  must  be  followed  by  a  slash  (/). 

portnumber  Specifies  a  port  number.  Valid  values  for  port  number  vary, 

depending  on  the  switch  type.  This  operand  is  required. 

distance_level  Refer  to  the  Description  section  for  information  about  the 

value. 

vc_translation_link_ini     Specifies  the  long-distance  link-initialization  sequence;  1 
t  activates  and  0  deactivates  this  mode.  When  the  command 

is  run  without  specifying  a  value,  1  is  assigned  automatically 
for  the  long  distance  link.  This  operand  is  optional 

desired_distance  Refer  to  the  Description  section  for  information  about  the 

value. 
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Examples 


To  configure  a  port  to  support  a  1 00  km 

link  and  be  initialized 

using  long-distance 

link  initializat 

protocol : 

switch : admin>  portcf glongdistance  4/15  L2  1 

switch : admin>  portshow  4/15 

portCFlags:  0x1 

portFlagS:    0x2  0001                 PRESENT  LED 

portType:  1.1 

portState:   2  Offline 

portPhys :      4  No_Light 

portScn:  0 

portid:  013f00 

portWwn:       20:3f :00:60:69:00 

: 02 :48 

Distance:     super  long  <=  100km 

portSpeed:  2Gbps 

Interrupts :  9 

Link_f allure : 

0 

Fr  jt : 

0 

Unknown :  0 

Loss_of_sync : 

0 

Fbsy: 

0 

Lli :  9 

Loss_of_sig : 

9 

Proc_rqrd:  0 

Protocol_err : 

0 

Timed_out :  0 

Invalid_word : 

0 

Rx_f lushed:  0 

Invalid_crc : 

0 

Tx_unavail:  0 

Deliin_err : 

0 

Free_buffer:  0 

Address_err : 

0 

Overrun :  0 

Lr_in : 

0 

Suspended:  0 

Lr_out : 

0 

Parity_err:  0 

01s_in: 

0 

2_parity_err :  0 

01s_out : 

0 

CMI_bus_err :  0 

See  also 

configure 
portcf gShow 
portshow 
switchShow 
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portCfgLPort 


Locks  a  port  as  an  L  Port. 


Synopsis 


portcfglport   [slotnumber/] portnumber  locked_mode  [private_mode] 
[  duplex_inode] 

Availability 

admin 

Description 

Use  this  command  to  designate  a  port  as  an  L  Port.  The  switch  then  only  attempts  to  initialize  that  port  as 
an  FL_Port.  By  default,  the  L  Port  is  a  public  L  Port.  It  can  be  set  to  private  L_Port  and  the  FLOGI  is  rejected. 


The  switch  never  attempts  point-to-point  (F_Port)  initialization  on  the  port. 


Operands 


The  operands  are  as  follows: 


slotnumber 
portnumber 

1 ocked_mode 
pri vate_mode 
dupl ex_mode 


Specify  the  slot  number  of  the  port  to  be  configured,  followed  by 
a  slash  (/)  (for  bladed  systems  only). 

Specify  a  port  number  to  be  configured,  relative  to  its  slot  for 
bladed  systems.  Use  switchShow  to  display  a  list  of  valid 
ports.  This  operand  is  optional;  if  omitted,  this  command 
displays  the  L_Port  conditions  for  all  ports. 

Specify  1  to  configure  the  specified  port  as  a  locked  L  Port. 
Specify  0  to  deconfigure  the  specified  port  from  its  previous  role 
as  a  locked  L_Port.  This  operand  is  required. 

Specify  1  to  configure  the  L  Port  as  a  private  L  Port.  Specify  0  to 
configure  the  L  Port  as  a  normal  public  L  Port.  The  default  value 
is  0. 

Specify  2  to  configure  the  specified  port  as  a  full-duplex  L  Port 
with  fairness.  Specify  1  to  configure  the  L  Port  as  a  half-duplex 
L  Port  with  fairness.  Specify  0  to  configure  the  L_Port  as  a 
full-duplex  L_Port.  The  default  value  is  0. 


If  used  without  operands,  this  command  reports  the  L_Port  conditions  for  all  ports  present. 
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Examples 

To  configure  a  port  as  a  locked  L  Port: 


switch : admin>  portcfglport  4/15,  1 

switch : admin>  portcfgshow 

[output  from  other  slots  suppressed] 

Ports  of  Slot  4 

0     1     2     3         4     5  6 

7 

8  9 

10  11 

12 

13 

14 

15 

-H  h--H  H  +  H  h  

-I  +  ■ 

+  -- 

H  + 

+  -- 

+  -- 

H  

Speed 

AN  AN  AN  AN       AN  AN  AN 

AN 

AN  AN 

AN  AN 

AN 

AN 

AN 

AN 

Trunk  Port 

ON  ON  ON  ON       ON  ON  ON 

ON 

ON  ON 

ON  ON 

ON 

ON 

ON 

ON 

Long  Distance 

VC  Link  Init 

Locked  L_Port 

ON 

Locked  G_Port 

Disabled  E_Port 

ISL  R_RDY  Mode 

Persistent  Disable    

where  AN : AutoNegotiate 

:OFF,    ??: INVALID. 

To  display  the  L_Port  conditions: 


switch: admin>  portc 

f glport 

[output  from  other 

slots 

suppre 

ssed] 

Ports  of  Slot  4 

0  1 

2  3 

4     5     6  7 

8     9  10  11 

12  13  14  15 

-+--+- 

--+--+- 

 H  h--H  +  

--  +  --H  +  - 

 +--+--+-- 

Locked  L  Port 

 ON 

Private  L  Port 

Locked  Loop  HD 

Loop  Fairness 

See  also 

configure 

Displays  port  status. 
switchShow 
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portCfgMcastLoopback 


Configures  a  port  to  receive  multicast  frames. 

Synopsis 

portCfgMcastLoopback  [slotnuiaber/]  portnuiaber,  mode 

Availability 

admin 

Description 

Use  this  command  to  allow  a  user  to  dedicate  an  unused  port  in  a  leaf  (edge)  switch,  with  no  F_Port 
belonging  to  a  multicast  group,  to  receive  multicast  frames. 

When  multicast  frames  are  received  at  an  edge  switch  with  no  member  port,  traffic  will  throttle  down  in  the 
KBytes/sec  range  as  embedded  processor  intervention  is  required  to  process  it. 

However,  when  a  port  is  assigned  as  the  multicast  loopback  port,  frames  destined  for  any  multicast  group 
are  routed  to  that  multicast  loopback  port  where  it  is  loopbacked  to  the  port's  receiver  that  is  turned  off. 
This  effectively  sends  the  frames  to  a  black  hole.  Since  the  embedded  processor  is  not  involved,  traffic 
moves  at  normal  (and  full)  speed. 

Executing  this  command  on  a  branch  (middle)  switch  does  not  affect  traffic.  It  can  be  configured  for  future 
use  as  an  edge  switch.  The  disadvantage  is  that  the  port  cannot  be  used  to  connect  to  other  devices. 

The  configuration  is  saved  in  the  flash  memory  and  is  persistent  across  switch  reboot  or  power  cycle.  The 
user  is  prompted  the  follow  occurs: 

•  The  selected  port  is  already  in  use  as  an  E  Port  or  Fx  Port 

•  The  switch  is  a  branch  (middle)  switch. 

A  warning  message  is  printed  if  another  port  is  already  configured  as  the  multicast  loopback. 
When  a  port  is  configured  as  multicast  loopback  port: 

•  Its  port  LED  blinks  a  slow  green  indicating  a  loopback  state.  Its  laser,  if  optical  GBICed,  is  disabled.  It 
does  not  respond  to  any  attempt  to  connect  it  to  any  device. 

•  The  comment  field  of  switchshow  displays  that  it  is  looped  back  to  itself  such  as: 

port     3 :   sw    No_Light  Loopback->3 

•  The  portFlags  line  of  portshow  displays  the  F_PORT  and  INT_LB  flags  such  as: 

portFlags:    0x20249  PRESENT  F_PORT  U_PORT  INT_LB  LED 

Operands 

The  operands  are  as  follows: 

slotnumber  Specifies  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director 

2/1  28.  For  all  other  switches,  this  operand  is  not  required.  The  slot 
number  must  be  followed  by  a  slash  (/)  and  the  port  number. 

The  Core  Switch  2/64  and  SAN  Director  2/1 28  have  a  total  of  1 0  slots. 
Slot  numbers  5  and  6  are  control  processor  (CP)  cards,  and  slots  1 
through  4  and  7  through  10  are  port  cards.  There  are  16  ports  on  each 
port  card,  counted  from  the  bottom  up,  0  to  15. 

portnumber  Specifies  a  port  number.  Valid  values  for  port  number  vary,  depending 

on  the  switch  type.  This  operand  is  required. 
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mode  Specify  a  value  of  1  means  portnumber  \s  dedicated  as  a  multicast 

loopback  port.  A  value  of  0  means  port  number  is  unconfigured  from  its 
previous  role  as  a  multicast  loopback  port. 

Examples 

To  configure  a  switch)  port  63  as  a  multicast  loopback  port: 

switch: admin>  portcf gmcastloopback  4/15  1 

See  also 

configure 

Displays  port  status. 
switchShow 
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portCfgPersistentDisable 

Disables  a  port  persistently. 

Synopsis 

portcf gpersistentdisable  [ slotnumber / ] portnumber 

Availability 

admin 

Description 

Use  this  command  to  persistently  disable  a  port.  Persistently  disabled  ports  remain  disabled  across  power 
cycles,  switch  reboots,  and  switch  enables.  By  default,  a  port  is  enabled  persistently.  The  change  in 
configuration  is  effective  immediately. 

The  persistent  disable  configuration  overrides  all  other  port  configurations  but  it  does  not  change  the 
configuration  of  any  other  port  settings.  Use  the  portCf  gPersistentEnable  command  to  enable  a 
port  persistently.  A  persistent-enabled  port  reenables  all  previously  set  port  configurations  of  that  port. 

The  switch  still  runs  power-on  diagnostics  and  initializes  a  persistently  disabled  port.  The  portEnable 
command  fails  when  directed  to  a  persistently  disabled  port.  The  switchEnable  command  does  not 
enable  the  persistently  disabled  ports  of  that  switch,  and  the  bladeEnable  command  does  not  enable 
the  persistently  disabled  ports  of  that  blade.. 

The  persistent  switch  disable  or  enable  configuration  does  not  alter  the  persistent  disable  or  enable 
configurations  of  the  ports  within  the  switch. 

Because  the  default  state  of  the  port  is  persistently  enabled,  the  persistent  disable  state  is  cleared  by  the 

portcf gDefault  command. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

configure,  followed  by  a  slash  (/). 

portnumber  Specify  a  port  number  to  configure,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  display  a  list  of  valid  ports.  This 
operand  is  optional;  if  omitted,  this  command  displays  the 
persistently-disabled  condition  for  all  ports. 

Examples 

To  configure  a  port  as  persistently  disabled  and  then  display  all  ports  that  are  permanently  disabled: 

switch : admin>  portcf gpersistentdisable  9/3 
switch : admin>  portcf gpersistentdisable 

Slot  9  0       1       2       3       4       5       6       7       8       9     10     11     12     13     14  15 

Disabled      _      _      _     yes     -      --      --      --      --      --  - 

(output  truncated) 

See  also 

portCfgDefault 
portDisable 
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portEnable 

portCf gPersistentEnable 

portShow 

switchShow 
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portCfgPersistentEnable 


Enables  a  port  persistently. 

Synopsis 

portcf  gpersistentenable  [  slotnuiaber/]  portnuiaber 

Availability 

admin 

Description 

Use  this  command  to  persistently  enable  a  port.  Persistently  enabled  ports  remain  enabled  across  power 
cycles,  switch  reboots,  and  switch  enables.  By  default,  a  port  is  enabled  persistently.  The  change  in 
configuration  is  effective  immediately. 

A  persistent  port  enable  reenables  all  previously  set  port  configurations  of  that  port.  A  persistently  enabled 
port  can  temporarily  be  disabled  by  the  portDisable  or  switchDisable  command.  The 
switchDisable  command  will  also  disable  the  persistently  enabled  ports  of  that  switch. 

The  persistent  switch  disable  or  enable  configuration  does  not  alter  the  persistent  disable  or  enable 
configurations  of  the  ports  within  the  switch. 

The  configuration  commands  conf  igDef ault  and  portCf gDef  ault  do  not  modify  the  persistent 
enable  attribute  of  a  port. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

configure,  followed  by  a  slash  (/). 

portnumber  Specify  a  port  number  to  configure,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  display  a  list  of  valid  ports.  This 
operand  is  optional;  if  omitted,  this  command  displays  the 
persistently  enabled  condition  for  all  ports. 

When  no  operand  is  specified,  the  command  reports  the  current  port  persistently  enabled  status  for  all 
ports  in  the  switch.  The  value  of  yes  is  displayed  for  ports  that  are  persistently  enabled. 

Examples 

To  configure  a  port  as  persistently  enabled  and  then  display  all  ports  that  are  persistently  enabled: 


switch : admin>  portcf gpersistentenable 

9/3 

switch : admin>  portcf gpersistentenable 

Slot  9  0123456 

7  8 
 1  

9     10     11     12     13     14  15 

Enabled       YES  YES  YES  YES  YES  YES  YES 

YES  YES 

YES  YES  YES  YES  YES  YES  YES 

(output  truncated) 
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See  also 

portDisable 
portDisable 
portEnable 

portCf gPers is tentDi sable 

portCf gShow 

portShow 

switchShow 
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portCfgShow 


Displays  port  configuration  settings. 


Synopsis 


portcfgshow  [slotnumber/]  [portnumber] 


Availability 

all  users 

Description 

Use  this  command  to  display  the  current  configuration  of  all  ports.  If  no  operand  is  specified,  all  the  port 
configuration  settings  are  displayed  for  that  switch  or  for  the  Core  Switch  2/64  logical  switch. 

The  following  configuration  information  displays: 


Speed  mode 
Trunk  Port  mode 

Long  Distance  mode 


VC  Link  Init  mode 
(virtual  channel) 


Locked  L  Port  mode 


Locked  G  Port  mode 


Disabled  E  Port  mode 


Mcast  LoopBack  mode 


ISL  R  RDY  Mode  mode 


Persistent  Disable  mode 


Displays  as  IG,  2G,  or  AN  (when  in  auto  speed  negotiation 
mode).  This  value  is  set  by  the  portCfgSpeed  command. 

Displays  as  ON  when  port  is  set  for  trunking  or  blank  (..)  when 
trunking  is  disabled  on  the  port.  This  value  is  set  by  the 

portCf gTrunkPort  command. 

Displays  as  blank  (..)  when  the  mode  is  off,  LI  when  the  link  is 
up  to  50  km,  or  L2  when  the  link  is  up  to  1 00  km,  and  also 
supports  LE,  L0.5,  and  LD  modes.  This  value  is  set  by  the 
portCf gLongDistance  command. 

Displays  as  blank  (..)  when  the  long-distance  link  initialization 
option  is  turned  off  and  (on)  when  it  is  turned  on  for  long 
distance  mode.  This  value  is  set  by  the 

portCf  gLongDistance  command. 

Displays  as  ON  when  port  is  locked  to  L_Port  only  or  blank  (..) 
when  L_Port  lock  mode  is  disabled  (and  it  behaves  as  a  U_Port). 
This  value  is  set  by  the  portCf  gLPort  command. 

Displays  as  ON  when  port  is  locked  to  G_Port  only  or  blank  (..) 
when  G_Port  lock  mode  is  disabled  (and  it  behaves  as  a 
U_Port).  This  value  is  set  by  the  portCf  gGPort  command. 

Displays  as  ON  when  port  is  not  allowed  to  be  an  E_Port  or  blank 
(..)  when  the  port  is  allowed  to  function  as  an  E_Port.  This  value 
is  set  by  the  portCfgEPort  command. 

Displays  as  blank  (..)  when  mcast  loopback  mode  is  off,  and 
(on)  when  mcast  loopback  mode  is  enabled.  This  value  is  set  by 

the  portCf  gMcastLoopback  command. 

Displays  as  ON  when  the  port  has  been  R  RDY-mode  enabled  or 
blank  (..)  when  the  port  is  allowed  to  function  as  an  E_Port.  This 
value  is  set  by  the  portCf  giSLMode  command. 

Displays  as  ON  when  the  port  is  disabled  across  reboots  or 
power  cycles  or  (..)  when  the  port  is  allowed  to  function 
normally.  This  value  is  set  by  the 

portCf gPer sis tentDi sable  command. 
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Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specifies  the  slot  number  of  the  port  to 

display,  followed  by  a  slash  (/). 

portnumber  Specifies  the  port  number  to  display,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  display  a  list  of  valid  ports.  This 
operand  is  optional;  if  omitted,  this  command  displays 
information  for  all  ports. 

Examples 

To  display  the  configuration  settings  of  a  switch: 

switch :user>  portcfgshow 

Ports  of  Slot  1         0123         4567         89  10  11 

Speed  ANANANAN       ANANANAN  ANANANAN 

Trunk  Port       

Long  Distance       

VC  Link  Init   

Locked  L_Port       

Locked  G_Port       

Disabled  E_Port   

ISL  R_RDY  Mode   

Persistent  Disable      


12  13  14  15 

 +  --  +  --H  

AN  AN  AN  AN 


Ports   of  Slot  4 


Speed 
Trunk  Port 
Long  Distance 
VC  Link  Init 
Locked  L_Port 
Locked  G_Port 
Disabled  E_Port 
ISL  R_RDY  Mode 
Persistent  Disable 


0     12     3         4     5     6     7         8     9  10  11       12  13  14  15 

 h--H  H  +  H  h--H  H  +  --H  h--H  +  --  +  --H  

ANANANAN       ANANANAN       ANANANAN  ANANANAN 


L2 
ON 


LI  L2 
ON  ON 


L2 
ON 


where  AN:AutoNegotiate,    ..:OFF,  ??:INVALID. 
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To  display  the  configuration  settings  of  a  port: 


switch :user>  portcfgshow 

4/15 

Area  Number : 

63 

Speed  Level : 

AUTO 

Trunk  Port 

OFF 

Long  Distance 

OFF 

VC  Link  Init 

OFF 

Link  Distance  Limit 

30  Km 

Locked  L_Port 

OFF 

Locked  G_Port 

OFF 

Disabled  E_Port 

OFF 

ISL  R_RDY  Mode 

OFF 

Persistent  Disable 

OFF 

Disabled  due  to  Buffer 

NO 

Locked  Loop  HD 

OFF 

See  also 

portCfgEPort 
portCfgGPort 
portCfgLongDi stance 
portCf gLPort 
portCf gSpeed 
portCf gTrunkPort 
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portCfgSpeed 


Configures  the  port  speed  level. 


Synopsis 


portcf gspeed  [slotnumber/] portnumber  speed_level 


Availability 

admin 


Description 

Use  this  command  to  configure  the  speed  of  a  port  to  a  particular  level.  After  this  command  is  issued,  the 
port  is  disabled  and  enabled  so  that  the  port  comes  up  v/ith  the  new  speed  setting.  The  configuration  is 
saved  in  the  flash  memory  and  is  persistent  across  sv^itch  reboot  or  pov/er  cycle. 

If  the  command  is  specified  without  an  operand,  you  are  prompted  to  enter  the  speed  value. 
Enter  Ctrl+D  to  cancel  the  configuration  update. 

The  output  of  the  portShow  command  displays  the  current  achieved  speed  of  a  port  and  the 
portcf  gShow  command  displays  the  user-desired  speed  setting  for  a  port. 


Operands 


This  command  has  the  following  operands: 

slotnumber 


portnumber 
speed_level 


Specify  the  slot  number  of  the  port  to  be  configured,  followed  by  a  slash 
(/)  (for  bladed  systems  only). 

Specify  a  port  number  to  be  configured,  relative  to  its  slot  for  bladed 
systems.  Use  switchShow  to  display  a  list  of  valid  ports. 

Specify  the  speed  of  a  port.  This  operand  is  required.  Valid  values  are 
one  of  the  following: 

0  Autosensing  mode.  The  port  automatically  configures  for  the 
highest  speed. 

1  1-Gb/s  mode.  The  port  is  at  fixed  speed  of  1  Gb/s. 

2  2-Gb/s  mode.  The  port  is  at  fixed  speed  of  2  Gb/s. 
4             4-Gb/ s  mode.  The  port  is  at  fixed  speed  of  4  Gb/ s. 


Examples 


To  configure  the  speed  of  a  port  to  2  Gb/s: 

switch: admin>  portcf gspeed  2/3,  2 


See  also 


portcf gShow 
portShow 
switchCf gSpeed 


436   Fabric  OS  commands 


portCfgTrunkPort 

Configures  a  port  to  be  enabled  or  disabled  for  HP  ISL  Trunking  license. 

Synopsis 

portcf  gtrunkport  [slotnumber/]  portnuraber  mode 

Availability 

admin 


NOTE:    This  command  requires  a  ISL  Trunking  license. 


Description 

Use  this  command  to  enable  or  disable  a  port  for  trunking. 

Operands 

This  command  has  the  following  operands: 

slotnumber  Specify  the  slot  number  of  the  port  to  be  configured,  followed  by 

a  slash  (/)  (for  bladed  systems  only). 

portnumber  Specify  a  port  number  to  be  configured,  relative  to  its  slot  for 

bladed  systems.  Use  switchShow  to  display  a  list  of  valid 
ports. 

mode  Specify  1  to  enable  this  port  for  trunking.  Specify  0  to  disable 

this  port  for  trunking.  This  operand  is  required. 

Examples 

To  enable  a  port  for  trunking: 

switch :  adinin>  portcf  gtrunkport  1/3  0 

See  also 

portcf gShow 

portShow 

swi  tchC  f gTrunk 

switchShow 
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portDebug 

Sets  debug  level  and  verbose  level  of  port  modules. 

Synopsis 

por t debug  djbg_lvl ,  vbs_lvl 

Availability 

admin 

Description 

Use  this  command  to  set  the  debug  level  and  verbose  level  of  port  modules. 

Operands 

This  command  has  the  following  operands: 

dbg_lvl  Specify  the  debug  level  to  be  set  for  port  modules;  valid  values  are  1  to  5. 

vbs_lvl  Specify  the  verbose  level  to  be  set  for  port  modules;  valid  values  are  1  to  5. 

Examples 

To  set  debug  level  and  verbose  level  of  port  modules: 

switch : admin>  portdebug  3  4 

See  also 

dbgShow 
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portDisable 

Disables  a  port. 

Synopsis 

portdisable  [  slotnumber/]  portnuiaber 

Availability 

admin 

Description 

Use  this  command  to  disable  a  port.  If  the  port  is  connected  to  another  switch,  the  fabric  might 
reconfigure.  If  the  port  is  connected  to  one  or  more  devices,  the  devices  can  no  longer  communicate  with 
the  fabric. 

If  the  port  was  online  before  being  disabled,  a  state  transition  will  be  indicated:  RSCN,  an  SNMP  trap,  a 
Web  pop-up  window. 

The  front-panel  LED  of  a  disabled  port  flashes  yellow  with  a  two-second  cycle. 

Operands 

This  command  has  the  following  operand: 

slotnumber  Specify  the  slot  number  of  the  port  to  be  disabled,  followed  by  a 

slash  (/)  (for  bladed  systems  only). 

portnumber  Specify  a  port  number  to  be  configured,  relative  to  its  slot  for 

bladed  systems.  Use  switchShow  to  display  a  list  of  valid 
ports. 

Examples 

To  disable  a  port: 

switch : adinin>  portdisable  2/4 

See  also 

portCf gPersistentDisable 

portCf gPersistentEnable 

portEnable 

portShow 

switchShow 
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portEnable 

Enables  a  port. 

Synopsis 

portenable  [slotnumber/]  portnuiaber 

Availability 

admin 

Description 

Use  this  command  to  enable  a  port.  If  the  port  is  connected  to  another  switch,  the  fabric  might  reconfigure. 
If  the  port  is  connected  to  one  or  more  devices,  the  devices  can  communicate  with  the  fabric. 

For  ports  that  come  online  after  being  enabled,  the  following  indications  might  be  sent  to  indicate  a  state 
transition:  RSCN,  SNMP  trap,  Web  pop-up  window. 

This  command  is  rejected  if  the  port's  switch  is  disabled,  the  port's  blade  is  not  fully  enabled  (faulted, 
powered  off,  or  disabled),  or  if  the  port  itself  is  persistently  disabled. 

The  front  panel  LED  of  an  enabled  and  online  port  is  green. 

Operands 

This  command  has  the  following  operand: 

slotnumber  Specify  the  slot  number  of  the  port  to  be  enabled,  followed  by  a 

slash  (/)  (for  bladed  systems  only). 

portnumber  Specify  a  port  number  to  be  configured,  relative  to  its  slot  for 

bladed  systems.  Use  switchShow  to  display  a  list  of  valid 
ports. 

Examples 

To  enable  a  port: 

switch : admin>  portenable  2/4 

See  also 

portCf gPersistentDisable 

portCf gPersistentEnable 

portDisable 

portShow 

switchShow 
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portErrShow 

Displays  port  error  summary. 

Synopsis 

porterrshow 

Availability 

all  users 

Description 

Use  this  command  to  display  an  error  summary  for  all  ports.  The  display  contains  one  output  line  per  port 
and  shows  error  counters  in  ones,  thousands  (k),  or  millions  (m). 

The  following  fields  are  displayed: 


frames  tx  Frames  transmitted 

frames  rx  Frames  received 

enc  in  Encoding  errors  inside  frames 

crc  err  Frames  with  CRC  errors 

too  shrt  Frames  shorter  than  minimum 

too  long  Frames  longer  than  maximum 

bad  eof  Frames  with  bad  end-of-frame  delimiters 

enc  out  Encoding  error  outside  of  frames 

disc  c3  Class  3  frames  discarded 

link  fail  Link  failures  (LFl  or  LF2  states) 

loss  sync  Loss  of  synchronization 

loss  sig  Loss  of  signal 

frjt  Frames  rejected  with  F  RJT 

fbsy  Frames  busied  with  F  BSY 


Operands 

none 

Examples 

To  display  error  counters  for  ports  on  a  switch: 


switch :user>  porterrshow 

frames    enc    crc  too 

too 

bad 

enc  disc  link  loss  loss  frjt 

fbsy 

tx      rx       in     err  shrt 

long 

eof 

out 

c3  fail  sync  sig 

0:     154     152        0        0  0 

0 

0 

2  .  Om 

0        12        0  0 

0 

1:     154     152         0         0  0 

0 

0 

1 .  9m 

0        12        0  0 

0 

(Continued  on  next  page) 
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See  also 

portShow 
port Stats Show 
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portFlagsShow 

Displays  the  port  status  bitmaps  for  all  ports  in  a  switch. 

Synopsis 

port flags show 

Availability 

all  users 

Description 

Use  this  command  to  display  the  following  status  for  a  port: 

SNMP  Displays  whether  the  port  is  online  or  offline. 

Physical  Displays  the  port  physical  status.  Valid  values  are  In  Sync  and 

No_Light. 

Flags  Displays  whether  there  is  an  SFP  inserted  in  the  port,  whether  the 

port  is  active,  and  the  port  type. 

Operands 

none 

Examples 

To  display  the  port  status  for  all  ports  in  the  switch. 

switch:user>  portf lagsshow 
Slot         Port         SNMP  Physical  Flags 


1 

0 

Online 

In_ 

.Sync 

PRESENT 

ACTIVE 

E. 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

1 

Online 

In_ 

_Sync 

PRESENT 

ACTIVE 

E. 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

2 

Online 

In_ 

_Sync 

PRESENT 

ACTIVE 

E. 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

3 

Online 

In_ 

_Sync 

PRESENT 

ACTIVE 

E. 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

4 

Online 

In_ 

_Sync 

PRESENT 

ACTIVE 

E. 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

5 

Online 

In_ 

_Sync 

PRESENT 

ACTIVE 

E. 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

6 

Online 

In_ 

_Sync 

PRESENT 

ACTIVE 

E. 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

7 

Online 

In_ 

_Sync 

PRESENT 

ACTIVE 

E. 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

8 

Offline 

No_ 

.Light 

PRESENT 

LED 

1 

9 

Offline 

No_ 

.Light 

PRESENT 

LED 

1 

10 

Offline 

No_ 

.Light 

PRESENT 

LED 

1 

11 

Offline 

No_ 

.Light 

PRESENT 

LED 

1 

12 

Online 

In_ 

.Sync 

PRESENT 

ACTIVE 

E. 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

13 

Online 

In_ 
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PRESENT 

ACTIVE 

E. 

.PORT 

G_ 

.PORT 

LOGIN 
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ACCEPT 

1 

14 

Online 

In_ 
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E. 

.PORT 

G_ 
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ACCEPT 

1 

15 
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G_ 
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4 
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Online 
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G_ 
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4 

1 

Online 

In_ 

.Sync 

PRESENT 

ACTIVE 

E. 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 
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4 

2 

Online 

In_Sync 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

3 

Online 

In_SYnc 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

4 

Offline 

No_Light 

PRESENT 

LED 

4 

5 

Offline 

No_Light 

PRESENT 

LED 

4 

6 

Online 

In_SYnc 

PRESENT  ACTIVE  F_PORT  L_PORT  LOGIN  NOELP  LED  ACCEPT 

4 

7 

Online 

In_SYnc 

PRESENT  ACTIVE  F_PORT  L_PORT  LOGIN  NOELP  LED  ACCEPT 

4 

8 

Online 

In_Sync 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

9 

Online 

In_SYnc 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

10 

Online 

In_SYnc 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

11 

Online 

In_SYnc 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

12 

Online 

In_SYnc 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

13 

Online 

In_SYnc 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

14 

Online 

In_SYnc 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

15 

Online 

In_SYnc 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

See  also 

portShow 


switchShow 
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portLedTest 

Cycles  user  port  LEDs. 

Synopsis 

portledtest   [-npass  count]  [-ports  itemlist] 

Availability 

admin 

Description 

Use  this  command  to  exercise  the  user  port  LEDs  in  the  current  switch  on  and  off  by  setting  the  ATTN  LEDs 
to  green  for  the  ON  condition  and  unlighted  for  the  OFF  condition.  The  SPEED  LEDs  are  initially  set  to 
black  before  the  command  execution.  The  SPEED  LEDs  are  set  to  green  once  the  command  is  executing. 

You  must  disable  the  current  switch  (using  the  switchDisable  command)  before  running  this  command. 
After  the  command  had  completed,  the  ATTN  LEDs  flash  amber,  indicating  that  the  command  has  finished 
and  exited.  You  can  enable  the  current  switch  (using  the  switchEnable  command)  to  set  the  ATTN  LEDs 
back  to  black. 

Operands 

This  command  has  the  following  optional  operands: 

-npass  count  Specify  the  number  of  times  to  perform  this  test.  The  default  value 

is  10. 

-ports  2  temlist  Specify  a  list  of  user  ports  to  run  the  test.  If  omitted,  all  the  active 

ports  in  the  switch  are  assumed.  For  more  information,  refer  to 
the  itemList  command. 

Examples 

To  test  port  LEDs: 

switch :adinin>  portledtest  -ports  1/1-1/5 
passed. 

See  also 

itemList 

switchDisable 

switchEnable 
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portLogClear 

Clears  the  port  log. 

Synopsis 

portlogclear 

Availability 

admin 

Description 

Use  this  command  to  clear  the  port  log.  You  might  want  to  clear  the  port  log  before  triggering  an  activity 
so  that  the  log  displays  only  the  log  events  related  to  that  activity. 

If  the  port  log  is  disabled,  the  following  message  appears  as  the  first  line. 

WARNING:  port  log  is  disabled 

If  the  port  log  is  disabled,  portLogClear  enables  it.  Certain  errors  automatically  disable  the  port  log  to 
preserve  information  needed  to  understand  the  error  (new  events  are  not  collected  so  that  existing 
information  is  not  overwritten). 

The  following  errors  disable  the  port  log: 

FCPH,  EXCHBAD 
FCPH,  EXCHFREE 
NBFSM,  DUPEPORTSCN 
UCAST,  RELICPDB 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

Operands 

none 

Examples 

To  clear  the  port  log: 

switch :admin>  portlogclear 
switch : admin>  portlogshow 
port  log  is  empty 

See  also 

portLogDump 
portLogShow 
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portLogConfigShow 

Displays  the  current  port  log  configuration. 

Synopsis 

portlogconf igshow 

Availability 

admin 

Description 

Use  this  command  to  display  the  current  port  log  configuration. 

Operands 

none 

Examples 

To  display  the  current  port  log  configuration: 

switch :  adinin>  portlogconf  igshow 
max  portlog  entries  =  8192 

See  also 

portLogResize 
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portLogDump 

Displays  the  port  log  without  page  breaks. 

Synopsis 

portlogdump  [count[,   saved[,  portid]]] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  port  log,  listing  all  entries  in  the  log  without  page  breaks.  This  command 
displays  the  same  information  as  portLogShow,  but  portLogShow  prompts  the  user  to  press  Enter 
between  each  page. 

If  the  port  log  is  disabled,  the  following  message  displays  as  the  first  line.  Refer  to  portLogClear 
command  for  more  information. 

WARNING:  port  log  is  disabled 

For  a  full  explanation  of  the  information  displayed  by  this  command,  refer  to  the  HP  StorageWorks  Fabric 
OS  4.x  procedures  user  guide. 

Operands 

This  command  has  the  following  operands: 

count  Specify  the  maximum  number  of  lines  to  be  displayed.  Only  the  most 

recent  count  entries  are  displayed.  This  operand  is  optional. 

saved  Specify  a  nonzero  value  to  display  the  saved  port  log  from  the  last  switch 

fault.  Refer  to  upTime  for  conditions  that  cause  a  fault.  The  operand 
count  is  ignored  when  displaying  the  saved  log.  This  operand  is 
optional. 

portid  Specify  the  port  to  display.  All  other  ports  will  not  be  displayed.  This 

operand  is  optional. 

Examples 

To  display  the  port  log  for  a  port: 


switch : user> 

portLogDump 

20 

time 

task 

event 

port 

cmd 

args 

08  :  35 

27 

899 

tShell 

pstate 

14 

OLl 

08  :  35 

27 

899 

tReceive 

pstate 

14 

LR2 

08  :  35 

27 

916 

tReceive 

pstate 

14 

AC 

08  :  35 

28 

416 

interrupt 

sen 

14 

1 

08  :  35 

28 

433 

tFabric 

ioctl 

14 

90 

101d9910, 0 

08  :  35 

28 

433 

tFabric 

Tx 

14 

164 

02f f f f fd, OOf f f f fd, OOOSffff, 10000000 

08  :  35 

28 

433 

tReceive 

Rx 

14 

0 

cOf f f f fd, OOf f f f fd, 00050006 

08  :  35 

28 

433 

tReceive 

Rx 

14 

164 

03fffffd, OOfffffd, 00050006,  02  000000 

08  :  35 

28 

433 

tTransmit 

Tx 

14 

0 

cOf f f f fd, OOfffffd, 00050006 

08:35 

28 

433 

tFabric 

ioctl 

14 

91 

103646d8, 0 

(continued 

on  next  page) 
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switch : user>  portLogDump  2  0 

time  task  event     port     cmd  args 


08 

35 

27 
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tShell 
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14 
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08 

35 

27 
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tReceive 

pstate 

14 
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08 
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27 
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08 

35 

28 

433 

tReceive 

Rx 

14 

0 
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35 
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14 

164 
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35 

28 

433 
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Tx 

14 

0 

cOfffffd, OOfffffd, 00050006 

See  also 

portLogClear 

portLogShow 

upTime 
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portLogDumpPort 

Displays  the  port  log  of  specified  port,  without  page  breaks. 

Synopsis 

portlogdumpport  portid 

Availability 

all  users 

Description 

Use  this  command  to  display  the  port  log  of  specified  port.  The  command  displays  all  entries  in  the  log 
without  any  page  breaks.  It  is  identical  to  portLogShowPort,  except  that  portLogShowPort  prompts 
the  user  to  press  Enter  between  each  page. 

Port  logs  are  circular  log  files  in  the  switch  firmware,  which  can  save  up  to  8,192  entries.  Refer  to 
portLogConf  igShow  to  display  the  current  port  log  size.  Once  the  log  is  full,  the  newest  log  entries 
delete  the  oldest  log  entries.  Port  logs  capture  switch-to-device,  device-to-switch,  switch-to-switch,  some 
device-to-device  1 ,  and  control  information 

If  the  port  log  is  disabled,  the  following  message  displays  as  the  first  line.  Refer  to  portLogClear 
command  for  more  information. 

WARNING:  port  log  is  disabled 
Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  procedures  user  guide  for  more  information. 

Operands 

This  command  has  the  following  operand: 

portid  Specify  the  area  number  of  port  to  display.  If  a  port  area  number  is 

specified,  all  other  ports  on  the  switch  are  ignored.  This  operand  is 
optional. 

Examples 

To  display  the  port  log  dump  for  a  port: 

switch :user>  portLogDumpPort  14 

time  task  event  port     cmd  args 


08 

:35 

27 
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tShell 
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08 

35 

28 
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tFabric 
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14 
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See  also 

portLogClear 

portLogShow 

upTime 
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portLog  EventShow 

Displays  information  about  port  log  events. 

Synopsis 

portlogeventshow 

Availability 

admin 

Description 

Use  this  command  to  display  information  about  the  ID  associated  with  the  various  port  log  events  and 
v/hether  the  events  are  enabled  or  disabled. 

Operands 

none 

Examples 

Display  information  about  port  log  events: 


switch. 

admin>  portlogeventshow 

ID 

Event -Name 

Disabled 

1 

start 

0 

2 

disable 

0 

3 

enable 

0 

4 

ioctl 

0 

5 

Tx 

0 

6 

Txl 

0 

7 

Tx2 

0 

8 

Tx3 

0 

9 

Rx 

0 

10 

Rxl 

0 

11 

Rx2 

0 

12 

Rx3 

0 

13 

Stats 

0 

14 

sen 

0 

15 

pstate 

0 

16 

rej  ect 

0 

17 

busy 

0 

18 

ctin 

0 

19 

ctout 

0 

20 

errlog 

0 

21 

loopscn 

0 

(continued  on  next 

page) 
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Q 
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switch 

0 
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0 

53 

routing 

0 

See  also 

portLogTypeDi sable 
portLogTypeEnable 
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portLoginShow 

Displays  port  login  status. 

Synopsis 

portloginshow  [ slotnumber/] portnumber 

Availability 

all  users 


Description 

Use  this  command  to  display  port  login  received  from  devices  attached  to  the  specified  port.  Some 
information  varies  v/ith  the  sv/itch  model  and  port  type.  The  follov/ing  lines  display: 

Type  Type  of  login: 

fe         FLOGI,  fabric  login  to  fabric  F_Port. 

ff         PLOGI,  process  login  to  specific  N_Ports  or  well-known  address, 
such  as  name  server. 

fd         FDISC,  virtual  N_Port  login. 

PID  The  port's  24-bit  DJD. 

WWN  The  port's  World  Wide  Name. 

credit  The  credit  for  this  login  as  appropriate.  This  is  BB  (buffer-to-buffer)  credit  for 

FLOGIs  and  EE  (end-to-end)  credit  for  PLOGIs. 

df_sz  The  default  frame  size  for  this  login. 

cos  Class  of  services  supported.  This  can  be  a  combination  of  the  following 

bits: 

4  Class  of  service  includes  class  2. 
8         Class  of  service  includes  class  3. 

There  is  further  information  about  the  login  after  the  above  columns.  This  can  include  the  DID  (destination 
identifier)  that  the  port  is  logged  on  to. 


Operands 


This  command  has  the  following  operands: 


slotnumber 


portnumber 


Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director 
2/1  28.  For  all  other  switches,  this  operand  is  not  required.  The 
slot  number  must  be  followed  by  a  slash  (  /  )  and  the  port 
number,  so  that  each  port  is  represented  by  both  slot  number  (1 
through  4  or  7  through  10)  and  port  number  (0  through  15). 

The  Core  Switch  2/64  or  SAN  Director  2/1  28  have  a  total  of 
1 0  slots.  Slot  numbers  5  and  6  are  control  processor  cards;  slots 
1  through  4  and  7  through  1 0  are  port  cards.  On  each  port 
card,  there  are  1 6  ports,  counted  from  the  bottom,  numbered  0 
to  15. 

Specify  a  port  number.  Valid  values  for  port  number  vary, 
depending  on  the  switch  type. 
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Examples 

To  display  login  information  for  port  23: 


switch : adinin>  portloginshow  23 

Type  PID 

World  Wide  Name 

credit  df  sz 

cos 

fe  201700 

21:00:00:e0:8b:05:a3 

c9 

3  2048 

8  scr=l 

ff  201700 

21:00:00:e0:8b:05:a3 

c9 

0  0 

8     d_id=FFFC2  0 

ff  201700 

21:00:00:e0:8b:05:a3 

c9 

0  0 

8  d_id=FFFFFC 

See  also 

f cpProbeShow 
portShow 
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portLogPdisc 

Sets  or  clears  the  debug_pdisc_flag. 

Synopsis 

portlogpdisc  Ivl 

Availability 

admin 

Description 

Use  this  command  to  set  or  clear  the  debug_pdisc_flag. 

Operands 

This  command  has  the  following  operand: 

Ivl        Specify  either  0  to  clear  the  flag  or  1  to  set  the  pdisc_flag. 

Examples 

To  set  the  pdisc_flag: 

switch: admin>  portlogpdisc  1 
PDISC  log  setting  =  1 

See  also 

none 
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portLogPortShow 

Displays  information  about  port  log  port  settings. 

Synopsis 

portLogPortShow 

Availability 

admin 

Description 

Use  this  command  to  display  information  about  whether  the  port  log  for  various  ports  is  enabled  or 
disabled.  1  in  the  right  column  indicates  port  log  for  that  port  is  disabled,  0  indicates  port  log  for  that  port 
is  enabled. 

Operands 

none 

Examples 

To  disable  the  information  about  the  port  log  settings: 


switch 

adinin>  portLogPortShow 

Port 

Disabled 

0 

1 

1 

0 

2 

0 

3 

0 

4 

0 

5 

0 

6 

0 

7 

0 

8 

0 

9 

0 

10 

0 

11 

0 

12 

0 

13 

0 

14 

0 

15 

0 

(continued  on  next  page) 
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See  also 

portLogEventShow 
portLogReset 
portLogTypeDi sable 
portLogTypeEnable 
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portLog  Reset 

Enables  the  port  log  facility. 

Synopsis 

portlogreset 

Availability 

admin 

Description 

Use  this  command  to  enable  the  port  log  facility. 

Refer  to  portLogClear  for  events  that  might  disable  the  port  log  facility. 

Operands 

none 

Examples 

To  enable  the  port  log: 

switch  :adinin>  portlogreset 

See  also 

portLogPortShow 
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portLogResize 

Resizes  the  port  log  to  the  specified  number  of  entries. 

Synopsis 

portlogresize  nuin_entries 

Availability 

admin 

Description 

Use  this  command  to  resize  the  port  log  to  specified  number  of  entries.  If  num_entries  is  less  than  the 
already  configured  port  log  size,  no  change  is  effected. 

Operands 

This  command  has  the  following  operand: 

num_entries  Specifies  the  number  of  entries  to  which  portlog  needs  to  be 

resized.  The  valid  range  of  values  is  8, 1 92  to  1 6,384. 

Examples 

To  resize  the  portlog: 

switch : admin>  portlogresize  12288 

See  also 

portLogConf igShow 
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portLogShow 

Displays  the  port  log. 

Synopsis 

portlogshow   [count,   saved,  portid] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  port  log,  page  by  page. 

The  portLogShow  command  displays  the  same  information  as  portLogDump,  but  it  enables  you  to 
press  Enter  after  each  page  of  output. 

Port  logs  are  circular  log  files  in  the  switch  firmware,  which  can  save  up  to  8,192  entries.  Refer  to 
portLogConf  igShow  to  display  the  current  port  log  size.  Once  the  log  is  full,  the  newest  log  entries 
delete  the  oldest  log  entries.  Port  logs  capture  switch-to-device,  device-to-switch,  switch-to-switch,  some 
device-to-device,  and  control  information. 

If  the  port  log  is  disabled,  the  following  message  displays  as  the  first  line.  Refer  to  portLogClear 
command  for  more  information. 

WARNING:  port  log  is  disabled 
The  following  information  displays  for  each  log  entry: 

Time  Displays  the  event  date  and  time  in  milliseconds.  The  clock  resolution  is  16 

milliseconds. 

Task  Displays  the  name  of  the  internal  switch  procedure  that  logged  the  event, 

interrupt  if  the  event  was  logged  in  interrupt  context,  or  unknown  if  the  task 
no  longer  exists. 

Event  Displays  the  task  event  that  generated  log  entry.  Possible  events  include: 


start 

A  switch  start  or  re-start  event 

disable 

A  port  is  disabled 

enable 

A  port  is  enabled 

iocti 

A  port  I/O  control  is  executed 

Tx 

A  frame  is  transmitted  (class  is  indicated) 

Rx 

A  frame  is  received  (class  is  indicated) 

sen 

A  state  change  notification  is  posted 

pstate 

A  port  changes  physical  state 

reject 

A  received  frame  is  rejected 

busy 

A  received  frame  is  busied 

ctin 

A  CT  based  request  is  received 

ctout 

A  CT  based  response  is  transmitted 

errlog 

A  message  is  added  to  the  error  log 

loopscn 

A  loop  state  change  notification  is  posted 

create 

A  task  is  created 

debug 

A  debug  message 

nbrfsm 

Neighbor  state  transition 
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sn 

Speed  negotiation  states 

fcin 

Incoming  fibre  channel  information  unit 

fcout 

Outgoing  fibre  channel  information  unit 

read 

Information  unit  header  log  from  read  operation 

write 

Information  unit  header  log  from  write  operation 

err 

Information  unit  header  log  of  an  fc  error  frame 

frame 

fc  frame  payload 

nsRemQ 

Inter-switch  name  server  query 

rscn 

RSCN 

xalloc 

Allocate  an  exchange 

xfree 

Free  an  exchange 

xerr 

Exchange  error 

xstate 

Exchange  state 

payload 

Frame  payload 

Port  Displays  the  port  number  that  logged  the  event. 

Cmd  Defined  by  the  event.  Displays  a  value  defined  by  the  event  as  follows: 

iocti  I/O  control  command  code 

Tx  &  Rx  Frame  payload  size 

sen  New  state  (see  state  codes  below) 

pstate  New  physical  state  (see  pstate  codes  below) 

ctin  The  CT-subtype: 

fc  Simple  Name  Server 

f8  Alias  Server. 

ctout  Same  as  ctin  above. 

errlog  Error  level  (refer  to  errShow) 

loopscn  Current  loop  state  during  loop  initialization,  possible  values 


are: 

OLP 

Offline  (disconnected  or  nonparticipating) 

LIP 

FL_Port  entered  INITIALIZING  or  OPENJNIT  state 

LIM 

LISM  completed,  FL_Port  became  the  loop  master 

BMP 

Loop  init  completed,  FL_Port  in  MONITORING 

state 

OLD 

Port  transited  to  the  OLD_PORT  state 

TMO 

Loop  init  times  out 

Args  Displays  additional  information  about  the  event  as  follows: 


start  Start  type:  0  =  enable  ports,  1  00  =  disable  ports 

disable  State  (refer  to  state  codes  next) 

enable  Mode:  0  =  normal 

non-zero  =  loopback 

Tx  &  Rx  Header  words  0, 1 ,4  (R_CTL,D_ID,S_ID,OX_ID,RX_ID)  and 

the  first  payload  word 

reject  FC-PH  reject  reason 

busy  FC-PH  busy  reason 
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ctin  Argument  0  is  divided  into  two  1 6-bit  fields: 

[A]  A  bit  map  indicating  whether  subsequent  orgs 
are  valid  (0001  means  argument  1  is  valid, 
0003  means  arguments  1  and  2  are  valid) 

Argument  1  is  the  first  word  of  the  CT  payload,  if 
applicable  (as  specified  in  [A]) 

Argument  2  is  the  second  word  of  the  CT 
payload,  if  applicable  (as  specified  in  [A]). 

[B]  The  CT-based  service  command  code 
ctout               Argument  0  is  also  divided  into  two  1 6-bit  fields: 

[A]  A  bit  map  indicating  whether  subsequent  orgs 
are  valid  (0001  means  argument  1  is  valid, 
0003  means  arguments  1  and  2  are  valid). 

[B]  The  CT  command  code  indicating  whether  an 
accept  (8002)  or  a  reject  (8001). 

If  [B]  is  an  accept,  argument  1  and  2  represents 
the  first  and  second  words  of  the  CT  payload,  if 
applicable  (as  specified  in  [A]). 

If  [B]  is  a  reject,  argument  1  contains  the  CT 
reject  reason  and  explanation  code. 

errlog  Error  type  (refer  to  errShow) 

loopscn         The  meaning  further  depends  on  each  loop  state: 

OLP  Offline  reason  code,  usually  zero 

LIP  Reason  code  for  LIPs  initiated  by  FL  Port,  if  the  code  value  is 

800x  (x  =  [1  ,Oxc],  see  below),  or  the  lower  two  bytes  of  the 
LIP  received,  if  the  code  value  is  other  than  800x 

LIM  Usually  zero 

BMP  Memory  address  for  the  loop  bitmap 

OLD  Usually  zero 

TMO  Encoded  value  of  the  state  when  loop  init  timed  out  This 

value  is  usually  equal  to  the  first  word  of  a  loop  init  frame 
payload.  Other  possible  values  include: 

2  LIP  (req.  INITIALIZING)  timeout 

94F0F0    ARB(FO)  timeout 

40  CLS  timeout 

Codes  used  in  various  fields  are  as  follows: 
state 


pstate 


1 

Online 

2 

Offline 

3 

Testing 

4 

Faulty 

5 

E_Port 

6 

F_Port 

7 

Segmented 

AC 

Active  State 

LRl 

Link  Reset:  LR  Transmit  State 

LR2 

Link  Reset:  LR  Receive  State 

LR3 

Link  Reset:  LRR  Receive  State 
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LFl 

Link  Failure:  NOS  Transmit  State 

LF2 

Link  Failure:  NOS  Receive  State 

OLl 

Offline:  OLS  Transmit  State 

OL2 

Offline:  OLS  Receive  State 

OL3 

Offline:  Wait  for  OLS  State 

LIP  reason  8001 

Retry  loop  init 

8002 

Start  loop  after  gaining  sync 

8003 

Restart  loop  after  port  reset 

8004 

LIP  when  a  loop  hanqs 

8005 

Restart  loop  if  LIP  received  when  sending  out  ARB(FO) 

8006 

LIP  when  an  OPN  returns 

8007 

Restart  loop  when  LIPs  received  in  OLD  PORT  AC  state 

8008 

Restart  loop  if  loop  not  empty  but  E  Port  loopback 

8009 

LIP  as  requested  by  the  LI  NIT  ELS  received 

800a 

LIP  as  requested  by  the  LPC  ELS  received 

800b 

Restart  loop  for  OuickLoop  looplet  setup 

800c 

Restart  loop  for  OuickLoop  looplet  re-initialization 

Speed  Negotiation  States 

INIT 

Start  negotiation 

NM 

Negotiate  master 

WS 

Wait  for  signal 

NF  Negotiation  follow 

NC  Negotiation  complete 

For  a  full  explanation  of  the  information  displayed  by  this  command,  refer  to  the  HP  StorageWorks  Fabric 
OS  4.x  procedures  user  guide. 

Operands 

This  command  has  the  following  operands: 

count  Specify  the  maximum  number  of  lines  to  display.  Only  the  most  recent 

count  entries  are  displayed.  This  operand  is  optional. 

saved  Specify  a  nonzero  value  to  display  the  saved  port  log  from  the  last  switch 

fault.  Refer  to  upTime  for  a  list  of  conditions  that  cause  a  fault.  The 
count  is  ignored  when  displaying  the  saved  log.  This  operand  is 
optional. 

portid  Specify  the  area  number  of  port  to  be  displayed.  If  a  port  area  number  is 

specified,  all  other  ports  on  the  switch  are  ignored.  This  operand  is 
optional. 
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Examples 

To  view  the  port  log  for  a  port: 


switch:user> 

portLogShow 

24 

time 

task 

event 

port 

cmd 

args 

17  : 

:  05  : 

30. 

.384 

PORT 

Rx 

0 

40 

02ff ff fd. 

OOf f f f fd, 08fbf f f f , 14000000 

17  : 

:  05  : 

30. 

.384 

PORT 

Tx 

0 

0 

cOff ff fd. 

OOf f f f fd, 08fb0e02 

17  ; 

:  05  : 

30. 

.384 

PORT 

debug 

0 

OOcOf fee. 

OOf d0118, 00000000, 00000001 

17  ; 

:  05  : 

30. 

.389 

PORT 

Rx 

1 

40 

02fffffd,00fffffd, 08fdf f f f ,  14000000 

17  : 

:  05  : 

30. 

.389 

PORT 

Tx 

1 

0 

cOff ff fd. 

OOff ff fd, 08fd0e03 

17  : 

:  05  : 

30. 

.389 

PORT 

debug 

1 

OOcOf fee. 

00fd013c, 00000000, 00000001 

17  ; 

:  05  : 

30. 

.504 

PORT 

Rx 

2 

40 

02ff ff fd, OOff ff fd, 08feffff, 14000000 

17  ; 

:  05  : 

30. 

.504 

PORT 

Tx 

2 

0 

cOf f f f fd, OOf f f f fd, 08fe0eQ4 

17  : 

:  05  : 

30. 

.504 

PORT 

debug 

2 

OOcOf fee. 

00fd0182, 00000000, 00000001 

17  : 

:  05  : 

30. 

.507 

PORT 

Rx 

3 

40 

02ff ff fd. 

00fffffd,08ffffff, 14000000 

17  ; 

:  05  : 

30. 

.507 

PORT 

Tx 

3 

0 

cOff ff fd. 

OOf f f f fd, 08f f 0e05 

17  ; 

:  05  : 

30. 

.508 

PORT 

debug 

3 

OOcOf fee. 

OOf d0148, 00000000, 00000001 

17  : 

:  05  : 

31. 

.081 

PORT 

Tx 

0 

40 

02ff ff fd. 

OOf f f f fd, 0e06f f f f , 14000000 

17  : 

:  05  : 

31. 

.082 

PORT 

debug 

0 

OOcOf fee. 

00fd0188, 14  000000, 00000001 

17  ; 

:  05  : 

31. 

.084 

PORT 

Rx 

0 

0 

cOfffffd,QOfffffd,0eO 60902 

17  ; 

:  05  : 

31. 

.772 

PORT 

Tx 

1 

40 

02ff ff fd. 

00fffffd,0e07ffff,  14000000 

17  : 

:05: 

31. 

.772 

PORT 

debug 

1 

OOcOf fee. 

00fd014a, 14  000000, 00000001 

17  ; 

:05: 

31. 

.774 

PORT 

Rx 

1 

0 

cOf f f f fd, OOf f f f fd, 0e0709Q6 

17  ; 

:05: 

31. 

.  775 

PORT 

Tx 

2 

40 

02ff ff fd. 

OOf f f f fd, 0e08f f f f , 14000000 

17  : 

:05: 

31. 

.775 

PORT 

debug 

2 

OOcOf fee. 

00fd015c, 14  000000, 00000001 

17  : 

:05: 

31. 

.777 

PORT 

Rx 

2 

0 

cOff ff fd. 

OOf f f f fd, 0e080907 

17  ; 

:05: 

31. 

.778 

PORT 

Tx 

3 

40 

02ff ff fd. 

OOf f f f fd, 0e09f f f f , 14000000 

17  ; 

:05: 

31. 

.779 

PORT 

debug 

3 

OOcOf fee. 

OOf d015e, 14000000, 00000001 

17  : 

:05: 

31. 

.782 

PORT 

Rx 

3 

0 

cOff ff fd. 

OOf fff fd, 0e090908 

See  also 

portLogClear 

portLogDump 

upTime 
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portLogShowPort 

Displays  the  port  log  of  specified  port,  with  page  breaks. 

Synopsis 

portlogshowport  [portid] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  port  log,  showing  22  entries  at  a  time.  It  is  identical  to 
portLogDumpPort,  except  that  portLogDumpPort  does  not  prompt  the  user  to  press  Enter  between 
each  page  of  output. 

If  the  port  log  is  disabled,  the  following  message  is  printed  as  the  first  line  (refer  to  portLogClear  for 
details): 

WARNING:  port  log  is  disabled 
Refer  to  the  portLogDump  command  for  more  information  on  the  data  returned  by  this  command. 

Operands 

This  command  has  the  following  operand: 

portid  Specify  a  nonzero  value  that  specifies  which  port  displays. 

Examples 

To  display  a  port  log  for  port  14: 

switch :user>  portLogShowPort  14 

time  task  event  port     cmd  args 


08 

35 

28 

483 

tFabric 

sen 

14 

0 

08 

35 

27 

899 

tShell 

pstate 

14 

OLl 

08 

35 

27 

899 

tReceive 

pstate 

14 

LR2 

08 

35 

27 

916 

tReceive 

pstate 

14 

AC 

08 

35 

28 

416 

interrupt 

sen 

14 

1 

08 

35 

28 

433 

tFabric 

ioctl 

14 

90 

101d9910, 0 

08 

35 

28 

433 

tFabric 

Tx 

14 

164 

02f f f f fd, OOf f f f fd, OOOSffff, 10000000 

08 

35 

28 

433 

tReceive 

Rx 

14 

0 

cOf f f f fd, OOf f f f fd, 00050006 

08 

35 

28 

433 

tReceive 

Rx 

14 

164 

03fffffd, OOfffffd, 00050006, 02  000000 

08 

35 

28 

433 

tTransmit 

Tx 

14 

0 

cOf f f f fd, OOfffffd, 00050006 

08 

35 

28 

433 

tFabric 

ioctl 

14 

91 

103646d8, 0 

08 

35 

28 

433 

tFabric 

ioctl 

14 

92 

103646d8, 0 

08 

35 

28 

466 

tFabric 

ioctl 

14 

a7 

3c,  1 

08 

35 

28 

466 

tFabric 

pstate 

14 

LRl 

08 

35 

28 

466 

tReceive 

pstate 

14 

LR3 

08 

35 

28 

466 

tReceive 

pstate 

14 

AC 

(continued  on  next  page) 
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08 

35 

28 

483 

tFabric 

Tx 

14 

96 

02fffffd, OOfffffd, 0006ffff, 11100060 

08 

35 

28 

483 

tReceive 

Rx 

14 

0 

cOf f f f fd, OOfffffd, 00060007 

08 

35 

28 

483 

tReceive 

Rx 

14 

96 

03f f f f fd, OOfffffd, 00060007, 021000  60 

08 

35 

28 

483 

tTransmit 

Tx 

14 

0 

cOf f f f fd, OOfffffd, 00060007 

08 

35 

28 

483 

tFabric 

ioctl 

14 

al 

0,0 

08 

35 

28 

483 

tFabric 

sen 

14 

5 

(output  truncated) 

See  also 

portLogClear 

portLogShow 

upTime 
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portLogTypeDisable 


Disables  the  port  log  of  a  specified  type. 

Synopsis 

portlogtypedisable  type 

Availability 

admin 

Description 

Use  this  command  to  disable  the  port  log  for  a  specified  port  log  type. 

Operands 

This  command  has  the  following  operand: 

type  Specify  a  nonzero  value  that  corresponds  to  the  port  log  type  to  be 

disabled.  The  values  corresponding  to  different  log  types  can  be 
obtained  by  running  portLogEventShow. 

Examples 

To  disable  event  2  from  reporting  to  the  portlog: 

switch: admin>  portlogtypedisable  2 

See  also 

portLogEventShow 
portLogTypeEnable 
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portLogTypeEnable 


Enables  the  port  log  of  a  specified  type. 

Synopsis 

portlogtypeenable  type 

Availability 

admin 

Description 

Use  this  command  to  enable  the  port  log  for  a  specified  port  log  type. 

Operands 

This  command  has  the  following  operand: 

type  Specify  a  nonzero  value  that  corresponds  to  the  port  log  type  to  be 

enabled.  The  values  corresponding  to  different  log  types  can  be 
obtained  by  running  portLogEventShow. 

Examples 

To  enable  event  2  to  report  to  the  port  log: 

switch : adinin>  portlogtypeenable  2 

See  also 

portLogEventShow 
per tLogTypeDi sable 
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portLoopbackTest 

Functional  test  of  port  N->N  path. 

Synopsis 

portloopbacktest   [--slot  number]  [-nframes  count] [-lb_mode  mode] 
[-spd_mode  mode]  [-ports  itemlist] 

Availability 

admin 

Description 

Use  this  command  to  verify  the  functional  operation  of  the  switch  by  sending  frames  from  the  port  N 
transmitter  and  looping  them  back  into  the  same  port  N  receiver.  The  loopback  is  done  at  the  parallel 
loopback  path.  The  path  exercised  in  this  test  does  not  include  the  media  or  the  fiber  cable. 

Only  one  frame  is  transmitted  and  received  at  a  time.  No  external  cable  is  required  to  run  this  test.  The 
port  LEDs  flicker  green  rapidly  v/hile  the  test  is  running. 

Following  is  the  test  method: 

1.  Set  all  ports  for  parallel  loopback. 

2.  Create  a  frame  F  of  maximum  data  size  (2,1 1  2  bytes). 

3.  Transmit  frame  F  through  port  N. 

4.  Pick  up  the  frame  from  the  same  port  N. 

5.  Check  the  eight  statistic  error  counters  for  nonzero  values: 

ENC_in,  CRC_err,  TruncFrm,  FrmTooLong,  BadEOF,  Enc_out,  BadOrdSet,  DiscCS 

6.  Check  if  the  transmit,  receive,  or  class  3  receiver  counters  are  stuck  at  some  value. 

7.  Check  if  the  number  of  frames  transmitted  is  not  equal  to  the  number  of  frames  received. 

8.  Repeat  step  2  through  step  7  for  all  ports  present  until: 

-  The  number  of  frames  (or  passcounf)  requested  is  reached. 

■  All  ports  are  marked  bad. 

At  each  pass,  the  frame  is  created  from  a  different  data  type.  If  seven  passes  are  requested,  seven  different 
data  types  are  used  in  the  test.  If  eight  passes  are  requested,  the  first  seven  frames  use  unique  data  types, 
and  the  eighth  is  the  same  as  the  first.  The  seven  data  types  are: 

1)  CSPAT:   Ox7e,    Ox7e,    0x7e,    0x7e,  ... 

2)  BYTE_LFSR:    0x69,    0x01,    0x02,    0x05,  ... 

3)  CHALF_SQ:   Ox4a,    0x4a,    0x4a,    Ox4a,  ... 

4)  QUAD_NOT:    0x00,    Oxff,    0x00,    Oxff,  ... 

5)  CQTR_SQ:    0x7  8,    0x7  8,    0x7  8,    0x7  8,  ... 

6)  CRPAT:    Oxbc,    Oxbc,    0x23,    0x47,  ... 

7)  RANDOM:   0x25,    Ox7f,    0x6e,    0x9a,  ... 

Because  this  test  does  not  include  the  media  or  the  fiber  cable  in  its  test  path,  its  results  combined  with  the 
results  of  crossPortTest  and  spinSilk  (both  of  which  loop  frames  using  an  external  loopback  cable) 
can  be  used  to  determine  which  components  of  the  switch  are  faulty. 
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Operands 


This  command  has  the  following  operands: 


-slot  number 


-nframes  count 


-lb  mode  mode 


-spd_mode  mode 


-ports  itemlist 


Specify  the  slot  number  on  which  the  diagnostic  will  operate.  The 
ports  specified  will  be  relative  to  this  slot  number.  The  default  is  set  to 

0  and  designed  to  operate  on  fixed-port-count  products. 

Specify  the  number  of  frames  to  send.  The  test  will  progress  until  the 
specified  number  of  frames  has  been  transmitted  on  each  port.  The 
default  value  is  1 0. 

Specify  the  loopback  mode  for  the  test.  By  default,  this  test  uses 
internal  loopback.  Valid  values  are  as  follows: 

1  Port  Loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 
5  Internal  (parallel)  loopback 

Specify  the  speed  mode  for  the  test.  This  parameter  is  used  only  with 
Bloom  and  Condor  ASIC-based  products,  where  it  controls  the  speed 
at  which  each  port  is  operated.  For  1  Gb/s-only  products,  it  is 
ignored.  The  exact  operation  of  speed  modes  5  through  8  depends 
upon  the  loopback  mode  selected.  When  speed  modes  5  through  8 
are  used  with  cables,  they  must  be  connected  even  to  odd  or  the  test 
will  fail. 

0  Runs  test  at  1  Gb/s,  2  Gb/s,  and  4  Gb/s. 

1  Runs  test  at  1  Gb/s. 

2  Runs  test  at  2  Gb/s  (Bloom  default). 

4         Runs  test  at  4  Gb/s  (Condor  default). 

For  lb_mode  ==  0,1  the  following  speed  modes  are  available  to  test 
the  speed  negotiation: 

3  Set  all  even  ports'  speed  for  autonegotiate;  set  all  odd  ports' 
speed  for  1  Gb/s. 

4  Set  all  even  ports'  speed  for  autonegotiate;  set  all  odd  ports' 
speed  for  2  Gb/s. 

5  Set  all  odd  ports'  speed  for  autonegotiate;  set  all  even  ports' 
speed  for  1  Gb/s. 

6  Set  all  odd  ports'  speed  for  autonegotiate;  set  all  even  ports' 
speed  for  2  Gb/s. 

For  IbMode  ==  2,3  the  following  speed  modes  are  available  to  test 
FIFO  underrun. 

3.5  Set  all  even  ports'  speed  for  2  Gb/s;  set  all  odd  ports' 
speed  for  1  Gb/s. 

4.6  Set  all  even  ports'  speed  for  1  Gb/s;  set  all  odd  ports' 
speed  for  2  Gb/s. 

Specify  a  list  of  user  ports  to  test.  By  default,  all  of  the  user  ports  in 
the  current  switch  are  tested.  This  option  can  be  used  to  restrict 
testing  to  the  specified  ports. 


Examples 


To  run  a  functional  test  of  a  connection: 


switch:admin>  portloopbacktest  -ports  1/38-1/45  -nframes  1  -lb_inode  1 

Running  Port  Loopback  Test  .... 

passed. 
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Diagnostics 

Following  are  possible  error  messages  if  failures  are  detected: 

DATA 

ERRSTAT 

INIT 

PORTDIED 
STATS 
TIMEOUT 
XMIT 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

camTest 

centralMemoryTest 

cmemRetentionTest 

cmiTest 

crossPortTest 

itemList 

portRegTest 

spinSilk 

sramRetentionTest 
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portName 


Assigns  or  displays  a  port  name. 


Synopsis 

portname  [slotnumber/]  portnuiaber,  name 


Availability 

admin 


Description 

Use  this  command  to  assign  or  display  a  port  name.  Both  port_number  and  port_name  operands  are 
optional  for  this  command. 

With  both  the  operands  present,  the  port  name  string  will  be  assigned  to  the  port.  With  only  the  port 
name  operand,  the  previously  assigned  port  name  will  be  displayed.  With  no  operands,  the  port  names 
of  all  the  ports  present  will  be  displayed. 

The  port  name  is  a  string  of  32  characters  or  fewer.  It  can  consist  of  white  spaces  or  printable  characters, 
excluding  the  characters  comma  ( ,  )  and  semicolon  ( ;  ).  By  default,  a  port  has  no  name  until  it  is  explicitly 
assigned  by  the  user. 

A  null  string  (that  is,  no  port_name  specified)  is  used  as  the  default  port  name  when  a  port  has  no 
user-assigned  name.  A  port  name  can  be  reset  to  the  default  value  by  executing  the  portName  command 
with  the  second  operand  a  null  string. 

Like  all  other  configurable  port  attributes,  port  name  persists  across  reboots  and  power  cycles.  It  will  not 
be  affected  by  conf  igDef  ault  command,  but  it  will  be  cleared  by  portCf gDef ault. 


Operands 


This  command  has  the  following  operands: 


slotnumber 


portnumber 


name 


Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director  2/1  28. 
For  all  other  switches,  this  operand  is  not  required.  The  slot  number  must 
be  followed  by  a  slash  (  /  )  and  the  port  number,  so  that  each  port  is 
represented  by  both  slot  number  (1  through  4  or  7  through  10)  and  port 
number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of  1 0  slots. 
Slot  numbers  5  and  6  are  control  processor  cards;  slots  1  through  4  and 
7  through  1 0  are  port  cards.  On  each  port  card,  there  are  1 6  ports, 
counted  from  the  bottom,  numbered  0  to  15. 

Specify  a  port  number.  Valid  values  for  port  number  vary,  depending  on 
the  switch  type.  This  operand  is  optional. 

Specify  a  port  name.  The  port  name  is  a  character  string  from  1  to  32 
characters,  including  spaces  and  characters  excluding  commas, 
semicolons,  and  asterisk.  To  erase  a  port  name,  specify  this  operand  as 
an  empty  string.  Quotation  marks  are  optional.  This  operand  is  optional; 
if  omitted,  it  displays  the  current  port  name. 
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Examples 

To  name  to  a  port: 


swi  tch : admin> 

portname 

1/3, 

"Tape  drive  8" 

switch : admin> 

portname 

1/3 

Tape  drive  8 

See  also 

configDe fault 
portCfgDe fault 
portShow 
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portPerfShow 

Displays  port  throughput  performance  in  bytes,  kilobytes,  or  megabytes. 

Synopsis 

portperfshow  [interval] 

Availability 

all  users 

Description 

Use  this  command  to  display  throughput  information  for  all  ports  on  the  switch  (8  or  16  columns, 
depending  on  the  switch  model).  One  output  line  is  displayed  per  interval  (or  second  if  no  interval  is 
specified)  until  return,  Ctrl+C,  or  Ctrl+D  is  pressed. 

This  command  displays  the  number  of  bytes  received  plus  the  number  of  bytes  transmitted  per  interval. 
Throughput  values  are  displayed  as  either  bytes,  kilobytes  (k),  or  megabytes  (m). 

Operands 

This  command  has  the  following  operand: 

interval  Specify  the  interval,  in  seconds,  between  each  sample.  This  operand  is 

optional. 

Examples 

To  display  port  throughput  for  a  switch: 


switch 

user>  portperfshow  20 

0  12 

3       4  5 

6 

7 

8 

9 

10     11     12     13  14 

15 

Total 

slot  1 

0       0  23k 

0       0  134k 

0 

12m 

0  7 

3m 

0  312m     0  l.lg  0 

0 

1.4g 

slot  2 

0  212m  0 

0   784k  0 

0 

0 

43m 

0 

85m     0  275k     0  498 

0 

341m 

0  12 

3       4  5 

6 

7 

8 

9 

10     11     12     13  14 

15 

Total 

slot  1 

0       0     2  6k 

0       0  160k 

0 

13m 

0  7 

5m 

0  310m     0  1.2g  0 

0 

1.3g 

slot  2 

0  178in  0 

0   812k  0 

0 

0 

43m 

0 

87m     0  272k     0  330 

0 

310m 

See  also 

port stats Show 
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portRegTest 

Reads  and  writes  test  of  the  ASIC  SRAMs  and  registers. 


Synopsis 


portregtest  [--slot  slotnumber]  [-ports  itemlist]  [-skiptests  mask]  [-verbose 
mode] 


Availability 

ad 


mm 


Description 

Use  this  command  to  verify  that  SRAM  and  register  data  bits  in  each  ASIC  can  be  independently  written 
and  read. 

The  test  method  used  is  to  write  a  walking  1  pattern  to  each  bit  location.  This  is  done  by  writing  a  pattern 
of  0x00000001  to  register  N.  Read  and  ensure  that  the  same  pattern  previously  written  is  read  back. 
Shift  the  pattern  to  the  left  by  1  bit  (to  Ox00000002)and,  repeat  the  write,  read,  and  compare  cycle.  Shift 
again  and  repeat  until  the  last  writable  bit  in  register  N  is  reached  (0x80000000  for  a  32-bit  register). 

For  example,  a  6-bit  register  is  effectively  tested  with  the  following  patterns: 


0x0001 
0x0010 
0x0100 
0x1000 


0x0002 
0x0020 
0x0200 
0x2000 


0x0004 
0x0040 
0x0400 
0x4000 


0x0008 
0x0080 
0x0800 
0x8000 


Repeat  these  steps  until  all  ASIC  SRAMs  and  registers  are  tested. 


Operands 


This  command  has  the  following  operands: 


-slot  slotnumber 


-ports  itemlist 


-skiptests  mask 


-verbose  mode 


Specify  the  slot  number  on  which  the  diagnostic  will  operate. 
The  ports  specified  will  be  relative  to  this  slot  number.  The 
default  is  0. 

Specify  a  list  of  blade  ports  to  test.  By  default,  all  the  blade 
ports  in  the  specified  slot  will  be  used.  Refer  to  itemList  for 
further  details. 

A  bit  mask  that  defines  which  of  the  register  test  subtests  to 
skip.  By  default,  all  subtests  will  be  performed.  Valid  mask 
values  include  one  or  more  of  the  following: 

0x2  Skip  retry  register  test. 

0x4  Skip  statistics  register  test. 

0x8  Skip  walk-1  test. 

0x1 0  Skip  credit  counter  test. 

Specify  a  nonzero  value  to  enable  verbose  mode.  The  default 
value  is  to  disable  this  mode. 
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Examples 

To  run  a  bit  write/ read  test  of  the  ASIC  SRAMs  and  registers: 

switch :adinin>  portregtest  -ports  1/0-1/15 

Running  Port  Register  Test  .... 

Test  Complete:    "portregtest"  Pass  1  of  1 

Duration  0  hr,    0  min  &  33  sec  (0:0:33:447). 

passed. 


Diagnostics 

When  this  command  detects  failure(s),  the  test  might  report  one  or  more  of  the  following  error  messages: 

BUS_TIMEOUT 

REGERR 

REGERR_UNRST 

Refer  to  the  HP  StorgageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

camTest 

centralMemoryTest 

cmemRetentionTest 

cmiTest 

crossPortTest 

itemList 

portLoopbackTest 
spinSilk 

sramRetentionTest 
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portRouteShow 

Displays  routing  tables  for  the  specified  port. 

Synopsis 

portrouteshow   [ slotnumber/] portnumber 

Availability 

all  users 


Description 

Use  this  command  to  display  the  port  address  ID  and  the  contents  of  the  following  port  routing  tables: 


External  unicast  routing  table 


Internal  unicast  routing  table 


Broadcast  routing  table 


Displays  how  the  specified  port  forwards  unicast  frames  to 
remote  domains  in  the  following  format: 

domain_number :  ports_bitmap 

•  domain  number  is  the  remote  domain  ID  to  which 
frames  are  ultimately  routed 

•  ports  bitmap  contains  the  port  number  on  the  ASIC 
pair  to  which  frames  for  the  domain  ID  forward  in 
bitmap  hex  format;  for  example,  0x0100  indicates  port 
8  on  the  ASIC  pair 

The  arrangements  of  ports  on  an  ASIC  pair  is  specific  to  the 
system  type.  For  any  active  port,  this  table  contains  at  least 
one  entry,  which  routes  unicast  frames  destined  to  the 
embedded  port  (value  0x1 0000)  of  the  local  domain. 

Displays  how  the  specified  port  forward  unicast  frames  to 
locally  attache  Nx_Ports  in  the  following  format: 

area_number:  ports_bitmap 

•  area  number  represents  the  area  number  of  a  device 
(or  set  of  looped  devices)  attached  to  the  local  switch 

•  The  format  of  ports  bitmap  is  the  same  as  the 
external  unicast  routing  table. 

Displays  how  the  specified  port  forwards  broadcast  frames. 
There  is  one  bit  map  entry  in  this  table,  similar  to  the  bit 
maps  in  the  other  tables;  however,  this  table  typically  has 
only  Bit  16  set  (value  0x10000),  indicating  this  port 
always  routes  broadcast  frames  to  the  embedded  port,  for 
handling  by  the  firmware. 


Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specifies  the  slot  number  of  the  port  to 

display,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  to  display,  relative  to  its  slot  for 

bladed  systems.  Use  switchShow  to  display  a  list  of  valid 
ports. 
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Examples 

To  display  the  routing  tables  for  a  port: 

switch:user>  portrouteshow  4/15 
port  address  ID:  Ox02bf00 
external  unicast  routing  table: 
1:   0x4  (vc=3) 
2:    0x10000  (vc=0) 
internal  unicast  routing  table: 

60:   0x8000  (vc=2) 

63:    0x1000  {vc=5) 
broadcast  routing  table: 

0x10000 

See  also 

bcastShow 
f abricShow 
switchShow 
topologyShow 
urouteShow 
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portShow 

Displays  port  status. 

Synopsis 

portshow   [slotnumber/] portnumber 

Availability 

all  users 

Description 

Use  this  command  to  display  status  information  for  tfie  specified  port,  as  shown  in  Table  18.  Information 
varies  with  the  switch  model  and  port  type. 

Table  18   portshow  display  fields 


Field 

Description 

portName 

Name  assigned  to  the  port  by  the  command  of  the  same  name. 

portHealth 

Current  health  of  the  port  (Fabric  Watch  license  required). 

Authentication 

Authentication  type  and  associated  parameters,  if  applicable,  used  on 
the  port  at  port  online  or  when  enabling  security,  whichever  occurs  last. 
States  include: 

None 

No  authentication  was  done. 

FCAP 

FCAP  authentication  was  done. 

DHCHP 

DH-CHAP  authentication  was  done. 

portDisableReason 

The  reason  that  a  port  has  been  disabled,  if  it  has  not  been  disabled  by 

portDisable  or  portCf  gPersistentDisable. 

portCFlags 

Port  control  flags. 

portFlags 

Bit  map  of  port  status  flags. 

portType 

Port  type  and  revision  numbers. 

portState 

Port  SNMP  state: 

Online 

Upand  running 

Offline 

Not  online;  portPhys  gives  details 

Testing 

Running  diagnostics 

Faulty 

Failed  diagnostics 

Persistently 
Disabled 

Persistently  disabled 

portPhys 

Port  physical  state: 
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Table  18   portshow  display  fields  (continued) 


Field 

Description 

No_Card 

No_Module 

No_Light 

No_Sync 

ln_Sync 

Laser_Flt 

Port_Flt 

Diag_Flt 

Lock_Ref 

No  interface  card  present 
No  module  (SFP  or  other)  present 
Module  not  receiving  light 
Receiving  light  but  out  of  sync 
Receiving  light  and  in  sync 
Module  is  signaling  a  laser  fault 
Port  marked  faulty 
Port  failed  diagnostics 
Locking  to  the  reference  signal 

portScn 

Last  state  change  notification  for  port. 

portid 

24-bit  DJD  for  port. 

portWwn 

Port  WWNs  of  device(s)  connected. 

Distance 

The  port's  long-distance  level.  In  case  of  LD  mode,  the  user  configured 
limit  and  actual  distances  also  are  displayed.  (Refer  to 

portCfgLongDi stance) 

The  port's  fixed  speed  level  (1  Gb/s  or  2  Gb/s)  or  negotiated  speed  (Nl 
Gb/s  or  N2  Gb/s)  level. 

Interrupts 

Total  number  of  interrupts. 

Unknown 

Interrupts  that  are  not  counted  elsewhere. 

Lli 

Low-level  interface  (physical  state,  primitive  sequences). 

Proc_rqrd 

Frames  delivered  for  embedded  N_Port  processing. 

Timed_out 

Frames  that  have  timed  out. 

Rx_f  lushed 

Frames  requiring  translation. 

Tx_unavail 

Frames  returned  from  an  unavailable  transmitter. 

Free_buffer 

Free  buffer  available  interrupts. 

Overrun 

Buffer  overrun  interrupts. 

Suspended 

Transmission  suspended  interrupts. 

Parity_err 

Real  Tx  data-parity  error. 
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Table  18   portshow  display  fields  (continued) 


Field 

Description 

£-    u(j  Illy   CI  I 

S^rr^nrinrx/  Tv  c\c\\c\-r\r\'C\\\i  ^rrr^r  Tn^c^  nr^  nr^f  r^n   Tv  c\c\\c\-r\c\'C\\\i  ^rrr^rc 
kjcL.^[iuu[y  lA  uuiu  Ljuiiiy           .  1 1 icoo  uic  I it^i  loui  lA  u<ji*hJ  Ljuiiiy  oii^io 

but  rather  forced  by  the  ASIC  due  to  certain  central  memory  errors  so  that 
the  transmitter  will  abort  the  frame.  This  field  will  only  be  displayed  when 
there  are  errors. 

CMI_bus_err 

Control  message  interface  errors. 

The  second  column  displays  link  error  status  block  counters. 


The  third  column  displays  the  number  of  F  RJTs  and  F  BSYs  generated.  For  L  Ports,  the  third  column  also 
displays  the  number  of  LIPs  received,  number  of  LIPs  transmitted,  and  the  last  LIP  received. 

Operands 

This  command  has  the  following  operands: 

slotnumber  Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director 

2/1 28.  For  all  other  switches,  this  operand  is  not  required.  The 
slot  number  must  be  followed  by  a  slash  (  /  )  and  the  port 
number,  so  that  each  port  is  represented  by  both  slot  number  (1 
through  4  or  7  through  10)  and  port  number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1 28  have  a  total  of 
1 0  slots.  Slot  numbers  5  and  6  are  control  processor  cards;  slots 
1  through  4  and  7  through  1 0  are  port  cards.  On  each  port 
card,  there  are  1 6  ports,  counted  from  the  bottom,  numbered  0 
to  15. 

portnumber  Specify  a  port  number.  Valid  values  for  port  number  vary, 

depending  on  the  switch  type.  This  operand  is  required. 

Examples 

To  display  the  state  of  a  port: 


switch:user>  portshow  2/15 

portName :  Tape  drive  8 

portHealth 

:  HEALTHY 

Authentication:   type  DHCHAP,   hash  SHAl,   group  0 

portDisableReason :  None 

portCFlags 

:  0x0 

portFlags : 

0x2  0001                 PRESENT  DISABLED  LED 

portType : 

1  .  1 

portState : 

2  Offline 

portPhys : 

2  No_Module 

portScn: 

0 

(continued 

on  next  page) 
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port  generation  number: 

n 
u 

portid:  815f00 

portWwn:        20: If: 

00:60:69: 

80:04:30 

portWwn  of  device (s)   connected:  None 

Distance:  normal 

portSpeed:  2Gbps 

Interrupts : 

0 

Link_f allure :  0 

r  X  J  u  . 

n 
u 

Unknown : 

0 

Loss_of_SYnc :  0 

Fbsy : 

u 

Lli  : 

0 

Loss_of_sig : 

0 

Proc_rqrd : 

0 

Protocol_err : 

0 

Timed_out : 

0 

Invalid_word : 

0 

Rx_f lushed : 

0 

Invalid_crc : 

0 

Tx_unavail : 

0 

Delim_err : 

0 

Free_buf f er : 

0 

Address_err : 

0 

Overrun : 

0 

Lr_in : 

0 

Suspended : 

0 

Lr_out : 

0 

Parity_err : 

0 

01s_in: 

0 

2_paritY_err : 

0 

01s_out : 

0 

CMI_bus_err : 

0 

See  also 

authUtil 

portCfgLongDi stance 
portLoginShow 
portName 
switchShow 
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portStats64Show 

Displays  the  64-bit  hardware  statistics  for  a  port. 

Synopsis 

ports tats 64show   [ slotnumber/] portnumber 

Availability 

all  users 

Description 

Use  this  command  to  display  the  following  hardware  statistics  for  a  port.  Two  integers  are  reported  for 
most  values.  In  such  cases,  the  top  word  is  the  most  significant. 


stat64_wtx 

Number  of  4-byte  words  transmitted. 

stat64_wrx 

Number  of  4-byte  words  received. 

stat64_ftx 

Frames  transmitted. 

stat64_frx 

Frames  received. 

stat64_c2_frx 

Class  2  frames  received. 

stat64_c3_frx 

Class  3  frames  received. 

stat64_lc_rx 

Link  control  frames  received. 

stat64_mc_rx 

Multicast  frames  received. 

stat64_mc_to 

Multicast  timeouts. 

stat64_mc_tx 

Multicast  trames  transmitted. 

f         /    A  1 

tim64_rdy_pri 

lime  K  KDY  riigri  priority. 

tim64_txcrd_z 

Time  BB_credit  zero. 

er64_enc_in 

r        1  •                •    •  1      r  r 
encoding  errors  inside  ot  trames. 

er64_crc 

Frames  with  CRC  errors. 

er64_trunc 

Frames  shorter  than  minimum. 

er64_toolong 

Frames  longer  than  maximum. 

er_bad_eof 

Frames  with  bad  end-of-frame. 

er64_enc_out 

Encoding  error  outside  of  frames. 

er64_disc_c3 

Class  3  frames  discarded. 

stat64_rateTxFrame 

Tx  frame  rate  (fr/sec). 

stat64_rateRxFrame 

Rx  frame  rate  (fr/sec). 

stat64_rateTxPeakFrame 

Tx  peak  frame  rate  (fr/sec). 

stat64_rateRxPeakFrame 

Rx  peak  frame  rate  (fr/sec). 

stat64_rateTxByte 

Tx  Byte  rate  (bytes/sec). 

stat64_rateRxByte 

Rx  Byte  rate  (Bytes/sec). 

stat64_rateTxPeakByte 

Tx  peak  Byte  rate  (Bytes/sec). 

stat64_rateRxPeakByte 

Rx  peak  Byte  rate  (Bytes/sec). 

stat64_PRJTFrames 

Number  of  P  RJT  frames  transmitted. 

stat64_PBSYFrames 

Number  of  P  BSY  transmitted. 

stat64_inputBuffersFull 

Occasions  on  which  input  buffers  are  fu 

stat64  rxClassl  Frames 

Class  1  frames  received. 
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Operands 

This  command  has  the  following  operands: 


slotnumber  Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director  2/1 28. 

For  all  other  switches,  this  operand  is  not  required.  The  slot  number  must 
be  followed  by  a  slash  (  /  )  and  the  port  number,  so  that  each  port  is 
represented  by  both  slot  number  (1  through  4  or  7  through  1 0)  and  port 
number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of  1 0  slots. 
Slot  numbers  5  and  6  are  control  processor  cards;  slots  1  through  4  and 
7  through  1 0  are  port  cards.  On  each  port  card,  there  are  1 6  ports, 
counted  from  the  bottom,  numbered  0  to  15. 

portnumber  Specify  a  port  number.  Valid  values  for  port  number  vary,  depending  on 

the  switch  type.  This  operand  is  required. 

Examples 

To  display  the  64-bit  hardware  statistics  for  a  port: 


switch:user>  portstats64show  4/15 

stat64_wtx 

0 

top_int   :   4-bYte  words  transmitted 

316 

bottom_int   :   4-byte  words  transmitted 

stat64_wrx 

0 

top_int   :   4-bYte  words  received 

1485 

bottom_int   :   4-bYte  words  receive 

stat64_f tx 

0 

top_int   :   Frames  transmitted 

69 

bottom_int   :   Frames  transmitted 

stat64_f rx 

0 

top_int   :   Frames  received 

73 

bottom  int   i   Frames  received 

stat54_c2_frx 

0 

top_int  :  Class  2  frames  received 

0 

bottom_int   :   Class  2  frames  received 

stat64_c3_f rx 

0 

top_int  :  Class  3  frames  received 

37 

bottom_int   :   Class  3  frames  received 

stat64_lc_rx 

0 

top_int   :  Link  control  frames  received 

8 

bottom_int   :   Link  control  frames  received 

stat54_mc_rx 

0 

top_int  :  Multicast  frames  received 

0 

bottom_int  :  Multicast  frames  received 

stat64_inc_to 

0 

top_int   :  Multicast  timeouts 

0 

bottom_int   :  Multicast  timeouts 

stat64_mc_tx 

0 

top_int   :  Multicast  frames  transmitted 

0 

bottom_int   :  Multicast  frames  transmitted 

tim64_rdY__pri 

0 

top_int   :  Time  R_RDY  high  priority 

60438254 

bottom_int   :   Time  R_RDY  high  priority 

tim64_txcrd_z 

0 

top_int   :  Time  BB_credit  zero 

2 

bottom_int   :  Time  BB_credit  zero 

er64_enc_in 

0 

top_int   :   Encoding  errors  inside  of  frames 

0 

bottom_int   :  Encoding  errors  inside  of  frames 

(continued  on 

next  page) 
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-v"      A          V*  *^ 
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top_ 

_int 

:   Frames  with  CRC  errors 

A 
VJ 

bottom_ 

int 

:   Frames  with  CRC  errors 

n 
u 

top_ 

_int 

:   Frames  shorter  than  minimum 

n 
u 

bottom_ 

int 

:   Frames  shorter  than  minimum 

SIT  6  4  too  long" 

u 

top_ 

_int 

:   Frames  longer  than  maximum 

n 
u 

bottom_ 

int 

:   Frames  longer  than  maximum 

r^^r^      ^  T~ 
c;X  UdU.  t=U  j- 

n 
u 

top_ 

_int 

:   Frames  with  bad  end-of-frame 

A 
U 

bottom_ 

int 

:   Frames  with  bad  end-of-frame 

sir6  4  snc  out 

n 
u 

top_ 

_int 

:   Encoding  error  outside  of  frames 

y  ±  J  ±  ±D  1 

bottom_int  : 

Encoding  error  outside  of  frames 

er64_disc_c3 

0 

top_ 

_int 

:   Class  3  frames  discarded 

0 

bottom_ 

int 

:  Class  3  frames  discarded 

stat64_rateTxFrame 

17 

Tx 

frame  rate  (fr/sec) 

stat64_rateRxFrame 

17 

Rx 

frame  rate  (fr/sec) 

stat64_rateTxPeakFrame 

17 

Tx 

peak  frame  rate  (fr/sec) 

stat64_rateRxPeakFrame 

17 

Rx 

peak  frame  rate  (fr/sec) 

stat64_rateTxBYte 

79 

Tx 

Byte  rate  (bytes/sec) 

stat64_rateRxByte 

371 

Rx 

Byte  rate  (Bytes/sec) 

state 4_rateTxPeakByte 

79 

Tx 

peak  Byte  rate  (Bytes/sec) 

stat64_rateRxPeakByte 

371 

Rx 

peak  Byte  rate  (Bytes/sec) 

stat64_PRJTFrames 

0 

top_int   :   4-bYte  words  transmitted 

0 

bottom_int   :   4-bYte  words  transmitted 

stat64_PBSYFrames 

0 

top_int   :   4-bYte  words  transmitted 

0 

bottom_int   :   4-byte  words  transmitted 

stat64_inputBuf f ersFull 

.  0 

top_int   :   4-bYte  words  transmitted 

0 

bottom_int   :   4-bYte  words  transmitted 

stat64_rxClasslFrames 

0 

top_int   :   4-bYte  words  transmitted 

0 

bottom_int   :   4-byte  words  transmitted 

See  also 


portStatsClear 
port Stats Show 
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portStatsClear 

Clears  the  hardware  statistics  of  a  specified  switch  port. 

Synopsis 

portstatsclear   [slotnumber/ ] portnumber 

Availability 

admin 

Description 

Use  this  command  to  clear  the  hardware  statistics  for  a  specified  switch  port.  At  the  same  time,  this 
command  also  clears  the  hardware  statistics  for  the  associated  ports  in  the  target  port  quad,  including 
AL_PA-based  CRC  monitor,  end-to-end  monitor,  and  filter-based  monitor  statistics. 

Operands 

This  command  has  the  following  operands: 

slotnumber       Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director  2/1  28. 

For  all  other  switches,  this  operand  is  not  required.  The  slot  number  must 
be  followed  by  a  slash  (  /  )  and  the  port  number,  so  that  each  port  is 
represented  by  both  slot  number  (1  through  4  or  7  through  10)  and  port 
number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of  1 0  slots. 
Slot  numbers  5  and  6  are  control  processor  cards;  slots  1  through  4  and 
7  through  1 0  are  port  cards.  On  each  port  card,  there  are  1 6  ports, 
counted  from  the  bottom,  numbered  0  to  15. 

portnumber       Specify  a  port  number.  Valid  values  for  port  number  vary,  depending  on 
the  switch  type.  This  operand  is  required. 

Examples 

To  clear  the  statistics  for  a  port: 

switch :ad[nin>  portstatsclear  4/15 

See  also 

portStats64Show 
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portStatsShow 

Displays  port  hardware  statistics. 

Synopsis 

port stats show   [slotnumber/] portnumber 

Availability 

all  users 

Description 

Use  this  command  to  display  port  hardware  statistics  counters. 


stat_wtx 

4-byte  words  transmitted. 

stat_wrx 

4-byte  words  received. 

stat_f tx 

Frames  transmitted. 

stat_f rx 

Frames  received. 

stat_c2_f rx 

Class  2  frames  received. 

stat_c3_f rx 

Class  3  frames  received. 

stat_lc_rx 

Link  control  frames  received. 

stat_mc_rx 

Multicast  frames  received. 

stat_mc_to 

Multicast  timeouts. 

stat_mc_tx 

Multicast  frames  transmitted. 

tim  rdv  pri 

Time  R  RDY  high  priority. 

tim_txcrd_z 

Time  BB  credit  zero. 

er_enc_in 

Encoding  errors  inside  frames. 

er_crc 

Frames  with  CRC  errors. 

er_trunc 

Frames  shorter  than  minimum. 

er_toolong 

Frames  longer  than  maximum. 

er_bad_eof 

Frames  with  bad  end-of -frame. 

er_enc_out 

Encoding  error  outside  frames. 

er_disc_c3 

Class  3  frames  discarded. 

f l_open 

Number  of  OPNyx  sent. 

f l_opened 

Number  of  OPNyx  received. 

f l_openf r 

Number  of  OPNfr  sent. 

f l_cls_idle 

CLS  sent  due  to  loop  idle. 

f l_cls_rx 

CLS  received  when  OPEN. 

fl_bb_stall 

OPN/CLS  BB_Credit  stalls. 

f l_cf_alloc 

Number  of  CFIFOs  allocated. 

f l_cf_opn 

CFIFOs  delivered  when  OPENED. 

fl_cf_full 

Number  of  CFIFOs  full  stalls. 

f l_cf _na 

CFIFO  not  available  stalls. 

f l_trig_age 

Number  of  age  count  triggers. 

f l_trig_lp 

Number  of  loop  not  busy  triggers. 

open 

Number  of  times  the  FL_Port  entered  OPEN  state. 
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transfer  Number  of  times  the  FL_Port  entered  TRANSFER 

state. 

opened  Number  of  times  the  FL  Port  entered  OPENED 

state. 

starve_stop  Loop  tenancies  stopped  due  to  starvation, 

f  l_tenancY  Number  of  times  FL_Port  had  loop  tenancy. 

nl_tenancY  Number  of  times  NL_Port  had  loop  tenancy. 

frame_nozone  Frames  rejected  due  to  zone  protection. 


Operands 

This  command  has  the  following  operands: 

slotnumber       Specify  the  slot  number  for  a  SCore  Switch  2/ 64  or  SAN  Director  2/1 28 
For  all  other  switches,  this  operand  is  not  required.  The  slot  number  must 
be  followed  by  a  slash  (  /  )  and  the  port  number,  so  that  each  port  is 
represented  by  both  slot  number  (1  through  4  or  7  through  10)  and  port 
number  (0  through  15). 

The  Core  Switch  2/64  and  SAN  Director  2/1  28  have  a  total  of  1 0  slots. 
Slot  numbers  5  and  6  are  control  processor  cards;  slots  1  through  4  and 
7  through  1 0  are  port  cards.  On  each  port  card,  there  are  1 6  ports, 
counted  from  the  bottom,  numbered  0  to  15. 

portnumber       Specify  a  port  number.  Valid  values  for  port  number  vary,  depending  on 
the  switch  type.  This  operand  is  required. 

Examples 

To  display  the  basic  set  of  statistics  for  a  port: 

switch:user>  portstatsshow  4/15 


stat_ 

_wtx 

494 

4-byte  words  transmitted 

stat_ 

_wrx 

760 

4-byte  words  received 

stat_ 

_f  tx 

28 

Frames  transmitted 

stat_ 

_f  rx 

32 

Frames  received 

stat_ 

_c2_f rx 

0 

Class  2  frames  received 

stat_ 

_c3_f rx 

32 

Class  3  frames  received 

stat_ 

_lc_rx 

0 

Link  control  frames  received 

stat_ 

_mc_rx 

0 

Multicast  frames  received 

stat_ 

_mc_to 

0 

Multicast  timeouts 

stat_ 

_mc_tx 

0 

Multicast  frames  transmitted 

(continued  on  next  page) 
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starve_stop 

0 

tsnanciss  stoppsd  dus  to  starvation 

f l_tenancy 

3277 

numbsr  of  timss  FL  has  ths  tsnancy 

nl_tenancy 

11 

numbsr  of  timss  NL  has  ths  tsnancy 

See  also 

portErrShow 
portShow 
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portSwap 


Swaps  area  numbers  of  two  switch  ports. 


Synopsis 

portswap    [slotnumber/ ]  portnumberl    [slotnuR±ier2  /  ]portnuinber2 

Availability 

admin 

Description 

Use  this  command  to  swap  area  numbers  for  a  pair  of  switch  ports.  Both  switch  ports  must  be  disabled 
prior  to  executing  this  command. 


NOTE:    To  undo  a  previous  port  swap,  execute  portSwap  again  on  the  same  two  ports. 

portSwap  information  is  kept  in  its  own  database;  it  cannot  be  manipulated  by  editing  the  configuration 
database  displayed  by  conf  igShow  and  conf  igUpload. 


Operands 


This  command  has  the  following  operands: 


portnumber2 


portnumberl 


slotnumber 


slotnumber2 


Examples 


To  swaps  area  numbers  between  a  pair  of  ports: 


switch : adinin>  portswap  1/2  2/5 
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See  also 

portDisable 

portEnable 

portShow 

portSwapDi sable 

portSwapEnable 

portSwapShow 

switchShow 
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portSwapDisable 


Disables  the  portswap  feature. 


portswapdi sable 


Availability 

admin 

Description 


Use  this  command  to  disable  the  portswap  feature.  The  portSwap  command  cannot  be  used  after  this 
feature  is  disabled. 

The  enabled  state  of  the  portswap  feature  is  persistent  across  reboots  and  power  cycles. 


NOTE:  Enabling  or  disabling  the  portswap  feature  does  not  effect  previously  performed  portswap 
operations. 


To  disable  the  portswap  feature: 

switch  ;adinin>  portswapdisable 


portDisable 

portEnable 

portShow 

portSwapEnable 

portSwapShow 

switchShow 


Synopsis 


Operands 


none 


Examples 


See  also 
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portSwapEnable 


Enables  the  portswap  feature. 

Synopsis 

portswapenable 

Availability 

admin 

Description 

Use  this  command  to  enable  the  portswap  feature.  The  portSwap  command  cannot  be  used  unless  the 
feature  is  first  enabled  with  this  command. 

The  enabled  state  of  the  portswap  feature  is  persistent  across  reboots  and  power  cycles. 

NOTE:    Enabling  or  disabling  the  portswap  feature  does  not  effect  previously  performed  portswap 
operations. 

Operands 

none 

Examples 

To  enable  the  portswap  feature: 

switch : admin>  portswapenable 

See  also 

portDisable 

portEnable 

portShow 

portSwapDi sable 

portSwapShow 

switchShow 
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portSwapShow 

Displays  the  state  of  the  portswap  feature. 

Synopsis 

portswapshow 

Availability 

admin 

Description 

Use  this  command  to  display  the  enabled  state  of  the  portswap  feature,  as  well  as  port  and  area 
information  for  those  ports  whose  area  number  id  different  from  the  default  area  number.  The  default  area 
number  of  a  port  is  same  as  its  switch  port  number. 

Operands 

none 

Examples 

To  display  the  enabled  state  of  the  portswap  feature  and  information  for  ports  whose  area  numbers  have 
been  swapped: 


switch  :adinin>  portswapshow 

PortSwap  is  enabled 

Slot         Slotport  Swport 

Area 

2               2  18 

19 

2              3  19 

18 

See  also 

portDisable 

portEnable 

portShow 

portswap 

portSwapDi sable 

portSwapEnable 

switchShow 
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portTest 

Performs  a  functional  test  of  a  switch  in  a  live  fabric. 

Synopsis 

porttest  [-ports  itemlist]  [-iteration  count] [-userdelay  time]  [-timeout 
time] [-pattern  pattern]  [-patsize  size]  [-seed  seed]  [-listtype  porttype] 

Availability 

admin 


Description 

Use  this  command  to  isolate  problems  to  a  single  replaceable  element  and  isolate  problems  to  near-end 
terminal  equipment,  far-end  terminal  equipment,  or  transmission  line.  Diagnostics  can  be  executed  every 
day  or  on  demand. 

This  command  verifies  the  intended  functional  operation  of  the  sv/itch  by  sending  frames  from  port  M's 
transmitter,  and  looping  the  frames  back  through  an  external  fiber  cable  into  port  M's  receiver,  thus 
exercising  all  the  sv/itch  components  from  the  main  board,  to  the  GBIC,  to  the  fiber  cable,  to  the  SFPs  (of 
the  devices  and  the  svvitch),  and  back  to  the  main  board. 

The  cables  and  SFPs  connected  should  be  of  the  same  technology:  a  short-wavelength  SFP  (switch)  port  is 
connected  to  another  short-wavelength  SFP  (device)  port  using  a  short-wavelength  cable;  a  long 
wavelength  port  is  connected  to  a  long-wavelength  port,  and  a  copper  port  is  connected  to  a  copper  port. 

Only  one  frame  is  transmitted  and  received  at  a  time.  The  port  LEDs  flicker  green  while  the  test  is  running. 

The  following  port  types  are  supported: 

•  E_Ports 

•  F_Ports  (must  support  ELS  ECHO) 

•  LPorts 

•  N->N  loopback  ports 

This  command  will  not  run  on  any  other  port  type. 
The  command  performs  the  following  actions: 

1.  Initiate  tests  on  certain  ports  (portTest  command). 

2.  Stop  active  tests  on  certain  ports  (stopPortTest  command). 

3.  Get  the  snapshot  of  the  test  result  (portTestSliow  command). 

Once  portTest  is  triggered,  you  can  use  stopPortTest  to  stop  the  test.  Refer  to  the  stopPortTest 
command  for  more  information. 

View  the  current  progress  of  portTest  by  running  portTestSlaow.  Refer  to  the  portTestShow 
command  for  more  information. 

If  there  is  a  port  type  change  during  portTest  execution,  the  test  will  continue  on  a  given  port  as  long  as 
it  can  be  supported  and  it  is  asked  to  do  so.  If  a  request  was  made  to  test  all  possible  ports  on  a  given 
switch,  portTest  will  start  a  new  test  using  the  new  port  type  to  start  a  appropriate  test. 
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Operands 


This  command  has  the  following  operands: 

-ports  itemlist 


-iteration  count 


-userdelay  time 


-timeout  time 


pattern 


-patsize  size 


-seed  seed 


-listtype  porttype 


Specify  a  list  of  user  ports  to  test.  By  default,  all  the  user  ports 
in  the  current  slot  is  assumed.  You  can  set  the  current  slot  by 
issuing  setslot  command.  Refer  to  itemList  help  pages  for 
further  details. 

Specify  the  number  of  times  (or  number  of  frames  per  port)  to 
execute  this  test.  Default  value  is  20.  Valid  values  are: 

0  Run  the  test  on  timeout  mode. 

-1  Run  indefinitely. 

Specify  the  delay  betv/een  frames  sent  by  portTest,  in 
minutes.  The  default  value  is  10  minutes. 

Specify  the  number  of  seconds  to  run  the  test.  Setting  the 
iteration  to  0  v/ill  set  the  portTest  into  timeout  mode.  The 
default  value  is  0. 

Specify  the  pattern  of  the  test  packets  payload.  Default  pattern 
type  is  RANDOM.  Twenty  types  of  predefined  patterns  are 
provided  with  the  test.  Use  the  dataTypeShow  command  to 
view  the  types  of  pattern  that  are  supported  with  portTest. 

Specify  the  size  of  the  pattern.  Default  size  of  the  pattern  is 
1 024  bytes.  Valid  range  of  values  are  4  bytes  through  2112 
bytes. 

Specify  the  seed  pattern  to  be  used  with  pattern.  Default  seed 
value  is  Oxaa. 

Specify  the  type  of  ports  to  run  portTest.  The  following 
values  are  predefined  for  porttype: 

-1  All  ports 

-2  All  LPorts 

-3  All  F_Ports 

-4         All  E_Ports 

-5  All  Loopback  ports 

The  default  value  is  -1 


Examples 

To  run  a  functional  test  on  an  active  switch: 


switch :adinin>  porttest  -ports  1/1-1/3 


See  also 

cross PortTest 

fportTest 

loopPortTest 

portLoopbackTest 

portTestShow 

spinFab 

stopPortTest 
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portTestShow 

Displays  information  from  portTest. 

Synopsis 

porttestshow   [-ports  itemlist] 

Availability 

admin 

Description 

Use  tfiis  command  to  display  a  snapshot  of  information  from  portTest.  Tfie  following  information 
displays: 

1.  Pass/Fail  information  on  a  given  port. 

2.  Port  type  tested. 

3.  Current  State  of  portTest  (NO  TEST,  TESTING,  or  TEST  DONE). 

4.  Type  of  ports  asked  to  test  (ALLPORTS,  ALLE_PORTS,  ALL_L_PORTS,  ALL_F_PORTS,  ALL_LB_PORTS,  or 
SINGLE_PORT). 

5.  Pattern  used  in  testing. 

6.  Seed  used  in  testing. 

7.  User  Delay  value. 

8.  Total  iteration  asked  to  test. 

9.  Current  test  iteration. 

10.  Total  Fails  on  this  test. 

1 1  .Consecutive  Fails  on  this  test. 
12. portTest  Start  Time. 
IS.portTest  Stop  Time. 

14.  Timeout  value. 

15.  Error  code  if  any. 

Operands 

This  command  has  the  follov/ing  optional  operands: 

-ports  i  temlist         Specify  a  list  of  user  ports  to  test.  By  default,  all  the  user  ports  in 

the  current  slot  will  be  assumed.  Refer  to  itemList  help  pages 
for  further  details. 
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Examples 

To  display  information  from  portTest: 


switch  :adinin>  porttestshow  1 

Port  1    :  PASS 

PortType :  OTHER 

PortState:  NO  TEST 

PortlnternalState :  INIT 

PortTypeToTest :  NO_TEST 

Pattern:   0x0  Seed: 

0x0                      UserDelay:  0 

Totallteration :  0 

Currentlteration :  0 

TotalFail:  0 

ConsecutiveFail :  0 

StartTime:  NONE 

StopTime:  NONE 

Timeout :  0 

ErrorCode :  0 

See  also 

cross PortTest 

fportTest 

loopPortTest 

portLoopbackTest 

portTest 

spinFab 

stopPortTest 
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powerOffListSet 


Sets  slot  power-off  list  order. 

Synopsis 

powerof f listset 

Availability 

admin 

Description 

Use  this  command  to  set  ttie  physical  power-off  slot  order.  The  system-available  power  is  compared  to  the 
system-demand  power  to  determine  if  there  is  enough  power  to  operate.  If  there  is  less  power  available 
than  the  demand,  the  power-off  list  is  processed  until  there  is  enough  power  for  the  system  to  operate. 

Note  that  if  the  system  abruptly  goes  from  a  state  with  enough  power  to  run  all  inserted  and  powered  FRUs 
to  a  state  with  too  little  power  to  run  everything,  no  processing  of  the  power  off  list  can  be  done.  This  is 
due  to  the  lack  of  power  causes  the  CP  boards'  processors  to  cease  executing  the  firmware.  In  this 
situation,  all  operation  of  the  system  terminates  immediately.  An  example  of  this  situation  is  when  a  third 
power  supply  is  removed  from  the  chassis,  so  that  suddenly  only  one  power  supply  is  available  to  power  a 
fully  loaded  system.  However,  if  the  system  is  running  on  two  power  supplies  (this  is  not  recommended) 
and  one  goes  into  predicted  fail  state  (in  which  the  power  supply  is  still  supplying  power),  the  power  off 
list  processes  as  described. 

The  format  of  the  display  varies,  depending  on  the  switch  model  and  the  number  of  slots  present. 
Operands 

none 

Examples 

To  modify  the  power-off  list  order: 

switch: admin>  powerOffListSet 


Slot        Current  POL 


10 

1st 

9 

2nd 

8 

3rd 

7 

4  th 

4 

5  th 

3 

6  th 

2 

7  th 

1 

8  th 

1st  slot  to  be  powered  off:  (1..10)  [10]  1 
2nd  slot  to  be  powered  off:    (2..  10)    [9]  2 


(continued  on  next  page) 
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6  th 

slot 

to 

be 

powered 

off: 

(7. 

9) 

[8] 

9 

7  th 

slot 

to 

be 

powered 

off: 

(7. 

8) 

[8] 

8 

8  th 

slot 

to 

be 

powered 

off: 

(7. 

7) 

[7] 

7 

Old 

POL 

New 

POL  Power 

Off 

Order 

10 

1 

1st 

9 

2 

2nd 

8 

3 

3rd 

7 

4 

4  th 

4 

10 

5  th 

3 

9 

6  th 

2 

8 

7  th 

1 

7 

8  th 

Proceed  to  change  the  POL  order?    (yes,  y,   no,   n) :    [no]  y 

See  also 

chassisShow 
powerOf f ListShow 
psShow 
slotPowerOf f 
slotPowerOn 
slotShow 
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powerOffListShow 

Displays  slot  power-off  list  order. 

Synopsis 

powerof f listshow 

Availability 

all  users 

Description 

Use  this  command  to  display  tfie  order  in  which  the  physical  slots  will  be  powered  off.  The 
system-available  power  is  compared  to  the  system  demand  power  to  determine  if  there  is  enough  power  to 
operate.  If  there  is  less  power  available  than  the  demand,  then  the  power-off  list  is  processed  until  there  is 
enough  power  for  the  system  to  operate. 

Note  that  if  the  system  abruptly  goes  from  a  state  with  enough  power  to  run  all  inserted  and  powered  FRUs 
to  a  state  with  too  little  power  to  run  everything,  no  processing  of  the  power  off  list  can  be  done.  This  is 
due  to  the  lack  of  power  causes  the  CP  boards'  processors  to  cease  executing  the  firmware.  In  this 
situation,  all  operation  of  the  system  terminates  immediately.  An  example  of  this  situation  is  when  a  third 
power  supply  is  removed  from  the  chassis,  so  that  suddenly  only  one  power  supply  is  available  to  power  a 
fully  loaded  system.  However,  if  the  system  is  running  on  two  power  supplies  (this  is  not  recommended) 
and  one  goes  into  predicted  fail  state  (in  which  the  power  supply  is  still  supplying  power),  the  power  off 
list  processes  as  described. 

The  format  of  the  display  varies,  depending  on  the  switch  model  and  the  number  of  slots  present. 
Operands 

none 

Examples 

To  display  the  slot  power  off  list  order: 

switch: admin>  powerOffListShow 


Slot 

10 

Slot 

9 

Slot 

8 

Slot 

7 

Slot 

6 

Slot 

5 

Slot 

4 

Slot 

3 

Slot 

2 

Slot 

1 

will  be 
will  be 
will  be 
will  be 
will  be 
will  be 
will  be 
will  be 
will  be 
will  be 


powered 
powered 
powered 
powered 
powered 
powered 
powered 
powered 
powered 
powered 


off  1st 

off  2nd 

off  3rd 

off  4th 

off  5th 

off  6th 

off  7th 

off  8th 

off  9th 

off  10th 
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See  also 

chassisShow 
powerOf f ListShow 
psShow 
slotPowerOf f 
slotPowerOn 
slotShow 
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psShow 

Displays  power  supply  status. 

Synopsis 

psshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  status  of  the  switch  power  supplies. 

The  format  of  the  display  varies  according  to  the  switch  model  and  number  of  power  supplies  present. 
Depending  upon  switch  model,  OEM  serial  ID  data  displays  after  each  power  supply  status  line. 

The  status  of  each  supply  is  displayed  as: 


OK  Power  supply  functioning  correctly, 

absent  Power  supply  not  present. 

Unknown  Unknown  power  supply  unit  installed. 

Predicting  Failure  Power  supply  is  present  but  predicting  failure, 

faulty  Power  supply  present  but  faulty  (no  power  cable,  power  switch 


turned  off,  fuse  blown,  or  other  internal  error). 
Optionally,  after  each  power  supply  status  line  is  the  OEM  serial  ID  data,  depending  on  the  switch  model. 

Operands 

none 

Examples 

To  view  the  status  of  the  power  supply  for  a  Core  Switch  2/ 64: 


switch : admin>  psShow 

Power  Supply  #1  is  OK 

DELTA  DPS-IOOIAB-IE  23000000601 

SI 

IXD0111000088 

Power  Supply  #2  is  faulty 

DELTA  DPS-IOOIAB-IE  23000000601 

SI 

IXD0111000162 

Power  Supply  #3  is  OK 

DELTA  DPS-IOOIAB-IE  23000000601 

SI 

IXD0111000120 

Power  Supply  #4  is  absent 
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To  view  the  status  of  the  power  supply  for  a  StorageWorks  SAN  Switch  2/32  switch: 


switch  :adinin>  psShow 

Power  Supply  #1  is  faulty 

013  5, FFOOO 000088, 60-000073  9 

-01, 

A, 

00001, SP467, lA, FF000000088 

Power  Supply  #2  is  OK 

013  5, FF000000089, 60-0000739 

-01, 

A, 

00001, SP467, 1A,FF000000089 

See  also 

f anShow 
tempShow 
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qloopAdd 

Adds  a  member  to  a  QuickLoop. 

Synopsis 

qloopadd  "gloopname" ,   " member ; member" 

Availability 

admin 


\^^}f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  add  one  or  more  members  to  an  existing  QuickLoop. 

When  a  configuration  is  enabled,  all  QuickLoops  defined  in  the  configuration  must  resolve  to  one  or  tv/o 
switch  worldv/ide  names. 

Zone  alias  names  entered  as  members  of  this  QuickLoop  must  be  defined  v/ith  WWNs.  Zone  alias  names 
that  are  defined  by  domain  and  port  number,  or  AL_PA  are  not  accepted  as  members  of  the  QuickLoop. 

NOTE:    When  security  is  enabled,  this  command  can  only  be  issued  from  the  primary  PCS  switch. 
Use  this  command  only  with  v3.x  systems  in  the  fabric;  QuickLoop  is  not  supported  in  v4.x. 


Operands 

The  following  operands  are  required: 

gloopname  Specify  the  name  of  QuickLoop,  in  quotation  marks. 

member  Specify  a  list  of  QuickLoop  members,  in  quotation  marks, 

separated  by  semicolons.  Include  one  or  more  of  the  following: 

World  Wide  Names 

Zone  alias  names 

Examples 

To  add  an  alias  for  a  second  WWN  to  "qlpl ": 

switch : admin>  qloopAdd  "qlpl",  "wwn2" 

See  also 

qloopCreate 
qloopDelete 
qloopRemove 
qloopShow 
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qloopCreate 

Creates  a  QuickLoop. 

Synopsis 

gloopcreate  "qloopname" ,   " member ; member" 

Availability 

admin 


\^^}f  NOTE:    This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  create  a  QuickLoop. 

A  QuickLoop  name  must  begin  with  a  letter  and  be  followed  by  any  number  of  letters,  digits,  and 
underscore  characters.  Names  are  case  sensitive,  for  example  Qloop_l  indicates  a  different  QuickLoop 
than  qloop_l  Spaces  are  ignored. 

The  QuickLoop  member  list  must  have  one  or  two  members;  an  empty  list  is  not  allowed. 

When  a  configuration  is  enabled,  all  QuickLoops  defined  in  the  configuration  must  resolve  to  a  maximum 
of  two  switch  worldwide  names. 

Zone  alias  names  entered  as  members  of  this  QuickLoop  must  be  defined  with  WWNs.  Zone  alias  names 
that  are  defined  by  domain  and  port  number,  or  AL  PA  are  not  accepted  as  members  of  the  QuickLoop. 

NOTE:   When  security  is  enabled,  this  command  can  only  be  issued  from  the  primary  PCS  switch. 
Use  this  command  only  with  v3.x  systems  in  the  fabric;  QuickLoop  is  not  supported  in  v4.x. 


Operands 

The  following  operands  are  required: 

qloopname  Specify  the  name  of  QuickLoop  to  be  created,  in  quotation 

marks.  The  qloopname  cannot  be  used  for  another  zone  object. 

member  Specify  a  list  of  members  to  be  added  to  QuickLoop,  in 

quotation  marks,  separated  by  semicolons.  Include  one  or  more 
of  the  following: 

World  Wide  Names 

Zone  alias  names 

Examples 

To  create  two  QuickLoops,  a  single  switch  and  one  dual  switch: 


switch 

adinin> 

qloopCreate 

"qlpl". 

"10 : 00 

00:60:69:00:60:11" 

switch 

ac3inin> 

qloopCreate 

■'qlp2"  , 

" wwn2 ; 

wwn3  " 
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See  also 

qloopAdd 

qloopDelete 

qloopRemove 
qloopShow 


508   Fabric  OS  commands 


qloopDelete 

Deletes  a  QuickLoop. 

Synopsis 

qloopdelete  "name 

Availability 

admin 


NOTE:    This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  delete  a  QuickLoop. 

This  command  changes  the  Defined  Configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  non-volatile  memory  using  the  cfgsave  command.  For  the  change  to  become  effective, 
an  appropriate  zone  configuration  must  be  enabled  using  the  cfgenable  command. 


NOTE:  When  security  is  enabled,  this  command  can  only  be  issued  from  the  primary  FCS  sv/itch. 
Use  this  command  only  v^ith  v3.x  systems  in  the  fabric;  QuickLoop  is  not  supported  in  v4.x. 


Operands 

The  follov/ing  operand  is  required: 

name  Specify  the  name  of  QuickLoop,  in  quotation  marks.  This 

operand  is  required. 

Examples 

To  delete  QuickLoop  "qloop2": 

switch :adinin>  qloopDelete  "qloop2" 

See  also 

qloopAdd 

qloopCreate 
qloopRemove 
qloopShow 
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qloopRemove 

Removes  a  member  from  a  QuickLoop. 

Synopsis 


qloopremove    qloopName  ,     member ; member 


Availability 

admin 


'=2^  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  remove  one  or  more  members  from  a  QuickLoop. 

The  member  list  is  identified  through  an  exact  string  match;  therefore,  when  removing  multiple  members, 
order  is  important.  For  example,  if  a  QuickLoop  contains  "wwn3;  wwn4",  removing  "wwn3;  wwn4" 
succeeds,  but  removing  "wwn4;  wwn3"  fails. 

If  all  members  are  removed,  the  QuickLoop  is  deleted. 

When  a  configuration  is  enabled,  all  QuickLoops  defined  in  the  configuration  must  resolve  to  one  or  two 
switch  worldwide  names. 

This  command  changes  the  Defined  Configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  non-volatile  memory  using  the  cfgsove  command.  For  the  change  to  become  effective, 
an  appropriate  zone  configuration  must  be  enabled  using  the  cfgenable  command. 

NOTE:    When  security  is  enabled,  this  command  can  only  be  issued  from  the  primary  FCS  switch. 
Use  this  command  only  with  vS.x  systems  in  the  fabric;  QuickLoop  is  not  supported  in  v4.x. 


Operands 

The  following  operands  are  required: 

qloopName  Specify  the  name  of  QuickLoop,  in  quotation  marks. 

member  Specify  the  list  of  QuickLoop  members  to  be  removed,  in 

quotation  marks,  separated  by  semicolons.  Include  one  or  more 
of  the  following: 

World  Wide  Names 

Zone  alias  names 

Examples 

To  remove  member  "wwn2"  from  "qlpl  ": 

switch : admin>  qloopRemove  "qlpl",  "wwn2" 
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See  also 

qloopAdd 

qloopCreate 
qloopDelete 
qloopShow 
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qloopShow 

Displays  QuickLoop  information. 

Synopsis 

qloopshow   [pattern]  [,  mode] 

Availability 

all  users 


NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  display  QuickLoop  configuration  information. 

If  no  parameters  are  specified,  all  zone  configuration  information  (defined  and  enabled)  is  displayed. 
Refer  to  cf  gshow  for  a  description  of  this  display. 

If  a  parameter  is  specified,  it  is  used  as  a  pattern  to  match  QuickLoop  names;  those  that  match  in  the 
defined  configuration  are  displayed. 

This  command  changes  the  Defined  Configuration.  For  the  change  to  be  preserved  across  sv/itch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cfgsave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgenable  command. 

'2^^  NOTE:   When  security  is  enabled,  this  command  can  only  be  issued  from  the  primary  FCS  sv/itch. 
Use  this  command  only  with  v3.x  systems  in  the  fabric;  QuickLoop  is  not  supported  in  v4.x. 


Operands 

The  follov/ing  operands  re  optional: 

pattern  Specify  a  POSIX  style  expression  used  to  match  QuickLoop 

names.  Patterns  can  contain  the  following  special  characters: 

•  Question  mark  "?",  which  matches  any  single  character 

•  Asterisk        which  matches  any  string  of  characters 

•  Ranges  "[0-9a-f]",  which  match  any  character  within  the 
range 

mode  Specify  1  to  display  the  contents  of  RAM,  specify  0  to  display 

the  contents  of  the  transaction  buffer.  The  default  value  is  0. 

Examples 

To  display  all  QuickLoops  beginning  with  the  letter  "q": 


switch 

admin> 

qloopshow  "q*" 

qloop : 

qlpl 

10:00:00 

60 

69 

00 

60 

11 

10:00:00 

60 

69 

00 

30 

02 

qloop 

qlp2 

10:00:00 

60 

69 

00 

60 

13 
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See  also 

qloopAdd 

qloopCreate 
qloopDelete 
qloopRemove 
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quietMode 

Sets  or  clears  the  telnet  session  quiet  mode,  or  displays  the  current  mode. 

Synopsis 

quietmode  [mode] 

Availability 

all  users  (display) 

admin  (modify) 
Description 

This  command  affects  the  output  displayed  on  the  switch  console  (telnet  session  only). 

By  default,  quiet  mode  is  off  and  all  switch  tasks  can  send  output  to  the  console.  Some  output  is  caused  by 
asynchronous  events,  such  as  the  fabric  reconfiguring  or  devices  logging  in. 

When  quiet  mode  is  on,  only  output  produced  by  shell  commands  displays;  all  asynchronous  output 
produced  by  other  tasks  suppresses.  This  is  useful  when  driving  a  telnet  session  through  a  script  that  might 
not  expect  any  asynchronous  output. 

Operands 

The  following  operand  is  optional: 

mode  0  Clears  quiet  mode  and  all  tasks  print  to  the  console 

1  Sets  quiet  mode  and  only  shell  commands  print 

The  current  value  displays  if  no  operand  is  specified. 

Examples 

To  display  the  current  mode  and  then  set  it  to  on: 

switch :  ac3inin>  quietMode 
quietMode:  On 

Usage:  quietMode  0|l 
0:   to  turn  it  off 
1:   to  turn  it  on 

switch : admin>  quietMode  0 
Quietmode  is  disabled. 

See  also 

none 
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rcslnfoShow 

Displays  the  reliable  commit  service  (RCS)  support  information. 

Synopsis 

rcsinf oshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  support  of  the  RCS  in  the  fabric.  The  command  displays  a  list  of  domains 
and  their  capabilities.  If  the  capability  parameter  is  0,  RCS  is  not  supported  on  that  switch.  If  the 
capability  parameter  is  greater  than  0,  RCS  is  supported  on  that  switch. 

RCS  is  a  fabric-wide  capability  and  is  supported  only  if  all  the  switches  in  the  fabric  support  RCS. 
g_rcsDisabled  parameter  shows  if  RCS  is  supported  in  the  fabric.  If  g_rcsDisabled  parameter  is  greater 
than  0,  RCS  is  not  supported  in  the  fabric.  If  g_rcsDisabled  parameter  is  0,  RCS  is  supported  in  the  fabric. 

Operands 

none 

Examples 

To  display  the  RCS  support  information: 


switch :user>  rcsinf oshow 

Domain  :     Version     :  capability 

2:                            1  1 

7 

49  :                          1  1 

7 

Domain  list 

2,  49, 

g_rcsDisabled  =  0 

g_rcsForceDisabled  =  0 

g_rcsMyDomain  =  1 

g_rcsVersion  =  1 

g_rcsCapability  =  7 

See  also 

none 
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reboot 

Reboots  either  one  control  processor  (CP)  or  the  entire  system. 

Synopsis 

reboot 

Availability 

admin 

Description 

Use  this  command  to  immediately  reboot  a  CP  or  an  entire  single-CP  system.  The  command  line  session  is 
closed. 

When  this  command  is  issued  on  the  active  CP  or  on  a  single-CP  system,  all  switches  in  the  system  are 
entirely  shut  down  and  all  Fibre  Channel  ports  become  inactive  until  the  system  restarts  or  the  standby  CP 
reinitializes  these  ports.  If  any  switch  was  part  of  a  fabric,  the  remaining  switches  reconfigure. 

When  this  command  is  issued  on  the  standby  CP,  high  availability  (HA)  synchronization  is  lost  until  the 
standby  CP  successfully  restarts. 

Operands 

none 

Examples 

To  reboot  the  CP: 

switch : admin>  reboot 
Rebooting. . . 


See  also 

f astBoot 
switchReboot 
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routeHelp 

Displays  a  list  of  FSPF-related  commands. 

Synopsis 

routehelp 

Availability 

all  users 

Description 

Use  this  command  to  display  a  list  of  FSPF-related  commands. 

Operands 

none 

Examples 

To  view  a  list  of  routing  related  commands: 


switch :  adinin> 

routehelp 

bcastShow 

Print  broadcast  tree  information 

dlsReset 

Turn  off  Dynamic  Load  Sharing 

dlsSet 

Turn  on  Dynamic  Load  Sharing 

dlsShow 

Print  state  of  Dynamic  Load  Sharing 

f spf Show 

Print  FSPF  global  information 

interf aceShow 

Print  FSPF  interface  information 

iodReset 

Turn  off  In-Order  Delivery 

iodSet 

Turn  on  In-Order  Delivery 

iodShow 

Print  state  of  In-Order  Delivery 

linkCost 

Set  or  print  the  FSPF  cost  of  a  link 

LSDbShow 

Print  Link  State  Database  entry 

nbrStateShow 

Print  neighbor ' s  summary  information 

nbrStatsClear 

Reset  FSPF  neighbor ' s  counters 

topologyShow 

Print  paths  to  domain (s) 

uRouteConf ig 

Configure  static  unicast  route 

uRouteRemove 

Remove  static  unicast  route 

uRouteShow 

Print  port ' s  unicast  routing  info 

See  also 

bcastShow 
interf aceShow 
urouteShow 
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saveCore 


Saves  or  removes  core  files  created  by  daemons. 


Synopsis 


To  FTP  core  files: 

savecore  [[-f  core-file-list] .. .  \  -F]  [-h  ip-address]  [-u  user_name  \  -a] 
[-p  password]  [-d  remote_directory] 

To  remove  core  files: 

savecore    [ [-r  core- files-directory-list] ...    |    -R  ] 
To  list  core  files: 

savecore  -1 


Availability 


admin 


Description 


Use  this  command  to  FTP  core  files,  to  remove  core  files,  or  to  list  core  files.  With  no  arguments, 
saveCore  enters  interactive  mode. 


Options 


This  command  has  the  following  options: 


-h  i.^-address 


Specify  a  host  name  if  FTP  requires  it. 


-u  user_name 


p  password 


Specify  a  user  name  for  the  host  name;  default  is 
anonymous. 

Specify  a  passv/ord  for  the  user  name. 


-1 


-a 


-R 


-f  core- file-directory-list 


d  remote_directory 


r  core- files-directory-list 
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Examples 

To  list  all  core  files  in  a  CP: 


switch :  adinin>  savecore  -1 
/core_f iles/panic/core . 873 
/core_f iles/zoned/core . 1234 
/core_f iles/zoned/core .5678 
/mnt/core_f iles/nsd/core . 873 
/mnt/core_f iles/panic/core . 873 

To  remove  selected  core  files  from  a  CP: 

switch :  adinin>  savecore  -r 

/core_f iles/panic/ , /core_f iles/zoned/ , /mnt/core_f iles/nsd/ 
Removing:    /core_f iles/panic/ 
Removing:    /core_f iles/zoned/ 
Removing;   /mnt/core_f iles /nsd/ 

To  remove  selected  core  files  from  the  CP  (using  multiple  -r  operands): 

switch : admin>  savecore  -r  /core_f iles/panic/  -r 
/core_f iles/zoned/ , /mnt/core_f iles 

/nsd/ 

Removing:  /core_f iles/panic/ 

Removing:  /core_f iles / zoned/ 

Removing:  /mnt/core_f iles/nsd/ 


To  remove  all  core  files: 


switch : admin> 

savecore  -R 

removing  core 

files  under: 

/core_f iles/panic 

removing  core 

files  under: 

/core_f iles/zoned 

removing  core 

files  under: 

/mnt/core_f iles/nsd 

removing  core 

files  under: 

/mnt/core_f iles/panic 

To  FTP  all  core  files: 

switch : admin> 

savecore  -h 

192.168.204.188  -u  jsmith  -d  core_f iles_here 

-p  fexosophy 

-F 

/core_f iles/panic/core . 873 : 
/core_f iles/zoned/core . 1234 : 
/core_f iles/zoned/core . 5678  : 
/mnt/core_f iles/nsd/core . 873 : 
/mnt/core_f iles/panic/core . 873 : 
Files  transferred  successfully! 


1.12  kB  381.87  B/s 

1.12  kB  382.14  B/s 

1.12  kB  382.50  B/s 

1.12  kB  381.93  B/s 

1.12  kB  381.90  B/s 
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To  FTP  selected  core  file  directories: 


switch : admin>  savecore  -h  192.16 
-p  password 

8.204.188  -u 

j smith  -d  core_ 

_f iles_here 

-f  /core_f iles/zoned/ , /innt/core_ 

f iles/nsd/ 

/core_files/ zoned/ /core . 1234 : 

1.12  kB  3f 

U.60  B/s 

/core_f iles/zoned/ /core . 557  8 : 

1.12  kB  3E 

31.95  B/s 

/innt/core_f  iles/nsd/  /  core .  873  : 

1.12  kB  3E 

32.53  B/s 

Files  transferred  successfully! 

To  remove  all  core  files  using  the  savecore  management  utility: 


switch : admin>  savecore 

following  1  directories  contains  core  files: 
[   ]0:    /mnt/core_f iles/panic 

Welcome  to  core  files  management  utility. 


Menu 

1  (or 

R)  : 

Remove  all  core  files 

2  (or 

F)  : 

FTP  all  core  files 

3  (or 

r)  : 

Remove  marked  files 

4  (or 

f )  : 

FTP  marked  files 

5  (or 

m)  : 

Mark  Files  for  action 

6  (or 

u)  : 

Un  Mark  Files  for  action 

9  (or 

e)  : 

Exit 

Your  choice:  1 

/mnt/core_f iles/panic 

You  have  opted  to  remove  ALL  core  files :- 
Please  confirm  (Y/ [N] ) :  y 
Removing  files. . . . 

removing  core  files  under:  /mnt/core_f iles/panic 
Done ! 

swi  tch : admin> 

switch : admin>  savecore 

No  core  files  found! 
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To  FTP  core  files  using  the  savecore  management  utility: 


switch :  adinin>  savecore 

following  1  directories  contains  core  files: 
[  ]0:   /core_f iles/zoned 


Welcome  to  core  files  management  utility. 


Menu 

l(or  R) :  Remove  all  core  files 

2 (or  F) :  FTP  all  core  files 

3 (or  r) :  Remove  marked  files 

4 (or  f ) :  FTP  marked  files 

5 (or  m) :  Mark  Files  for  action 

6 (or  u) :  Un  Mark  Files  for  action 

9 (or  e) :  Exit 


Your  choice :  F 
/core_f iles/zoned 

You  have  opted  to  FTP  these  core  files :- 
Please  confirm  (Y/ [N] ) :  y 
Destination  IP  Address?  192.168.10.10 
User  Name   [anonymous]?  jsmith 
Remote  Directory   [ . ] ?  bred 
Password:  ********** 

/core_files/zoned/core. 8323 :  1.12  kB     382.40  B/s 

Files  transferred  successfully! 
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To  remove  core  files  from  a  selected  directory: 


switch : admin>  savecore 

following  2  directories  contains  core  files: 
[  ]0:   /core_f iles/nsd 
[   ]1:    /core_f iles/zoned 

Welcome  to  core  files  management  utility. 


Menu 

1  (or 

R)  : 

Remove  all  core  files 

2  (or 

F)  : 

FTP  all  core  files 

3  (or 

r)  : 

Remove  marked  files 

4  (or 

f )  : 

FTP  marked  files 

5  (or 

m)  : 

Mark  Files  for  action 

6  (or 

u)  : 

Un  Mark  Files  for  action 

9  (or 

e)  : 

Exit 

Your  choice:  m 

Enter  File  Number  to  mark:  1 

Enter  CR  To  Continue. . . . 

following  2  directories  contains  core  files: 
[   ]0:    /core_f iles/nsd 
[*]1:    /core_f iles/zoned 

Welcome  to  core  files  management  utility. 


Menu 

1  (or 

R)  : 

Remove  all  core  files 

2  (or 

F)  : 

FTP  all  core  files 

3  (or 

r)  : 

Remove  marked  files 

4  (or 

f )  : 

FTP  marked  files 

5  (or 

m)  : 

Mark  Files  for  action 

6  (or 

u)  : 

Un  Mark  Files  for  action 

9  (or 

e)  : 

Exit 

Your  choice:  r 

/core_f iles/zoned 

You  have  opted  to  remove  core  files  under  these 

directories : - 

Please  confirm  (Y/ [N] ) :  y 

Removing  files. . . . 

removing  core  files  under:    /core_f iles/zoned 
Done ! 
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See  also 

none 
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secActiveSize 


Displays  the  size  of  the  active  security  database. 


Synopsis 


secactivesize 


Availability 


admin 


Description 


Use  this  command  to  display  the  size  of  the  active  security  database. 
The  maximum  is  256  KB. 

This  command  is  intended  strictly  for  debugging  purposes  by  technical  support  staff.  The  information 
displayed  might  not  be  supported  between  releases  and  is  subject  to  change  arbitrarily. 

[252)^  NOTE:    This  command  must  be  issued  from  a  sectelnet  or  SSH  session. 


Operands 


none 


Examples 


To  display  the  size  of  the  active  security  database: 


switch : admin>  secactivesize 


Size  of  security  active  data:   35  bytes    (Max  262144  bytes) 


See  also 


secDef ineSize 


secGlobalShow 
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secAuthSecret 


Manages  DH  CHAP  secret  key  information 


Synopsis 

secauthsecret   [--show] [--set] [--remove  value   |  --all] 

Availability 

admin 

Description 

Use  this  command  to  manage  the  DH  CHAP  shared  secret  key  database  used  for  the  authentication.  This 
command  displays,  sets,  and  removes  secret  key  information  from  the  database  or  deletes  the  entire 
database.  If  performing  set  or  remove  operations,  v/hen  the  command  completes  nev/  data  is  saved 
persistently.  Nev/  data  is  effective  v/ith  the  next  authentication  request.  The  configuration  applies  to  a 
switch  instance  only. 


'25^  NOTE:    Security  license  is  required  to  run  this  command  in  nonsecure  as  v/ell  as  secure  mode. 


Operands 


The  operands  are  as  follows: 


-sliow 


-set 


Lists  the  WWNs  to  which  shared  secret  is 
configured. 

Sets  shared  secrets  with  a  WWN. 


-remove  [wwn  \   domain  \   sw  name]     Removes  the  specified  WWN  entry  from  the 

database.  If  a  domain  name  is  specified,  it  is 
converted  to  WWN  and  then  the  entry  is 
removed.  If  no  option  is  specified,  command 
is  interactive. 


-remove  --all 


Deletes  the  entire  secret  key  database. 

Without  any  specified  operands,  the 
command  displays  the  usage. 


Examples 


To  list  the  shared  secret  WWN: 


switch :admin>  secauthsecret 


-show 


WWN 


Did 


Name 


10:00:00:50:69:80:5b:e8 


switch 
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To  set  the  shared  secret: 


switch: admin>  secAuthSecret  --set 

This  command  sets  up  secret  keys  for  the  DH-CHAP 

authentication.  The  minimum  length  of  a  secret  key  is  8 

characters  and  maximum  40  characters.   Setting  up  secret  keys 

does  not  initiate  DH-CHAP  authentication.   If  switch  is 

configured  to  do  DH-CHAP,    it  is  performed  whenever  a  port 

or 

a  switch  is  enabled. 

Warning:  Please  use  a  secure  channel  for  setting  secrets. 

Using 

an  insecure  channel  is  not  safe  and  can  compromise  secrets. 

Following  inputs  should  be  specified  for  each  entry. 

1.  WWN  for  which  secret  is  being  set  up. 

2.  Peer  secret:  The  secret  of  the  peer  that  authenticates 

to  peer. 

3.  Local  secret:  The  local  secret  that  authenticates  peer. 

Press  Enter  to  start  setting  up  shared  secrets  > 

Enter  WWN,   Domain,   or  switch  name   (Leave  blank  when  done) : 
10:00:00:60:69:80 

:05:14 

Enter  peer  secret: 

Re-enter  peer  secret: 

Enter  local  secret: 

Re-enter  local  secret: 

Enter  WWN,   Domain,   or  switch  name   (Leave  blank  when  done) : 

Are  you  done?    (yes,   y,   no,   n) :    [no]  y 

Saving  data  to  key  store...  Done. 
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To  remove  a  shared  secret  WWN: 


switch :adinin>  secAuthSecret  --remove 

This  command  deletes  database  of  DH-CHAP  secret  keys.  If 

a  fabric 

requires  authentication,   deleting  this  database  may  cause 

switch 

to  segment  from  the  fabric . 

Re-enter  peer  secret: 

Enter  local  secret: 

Re-enter  local  secret: 

Enter  WWN,   Domain,   or  switch  name   (Leave  blank  when  done) 

Are  you  done?    (yes,  y,   no,   n) :    [no]  y 

Saving  data  to  key  store...  Done. 

To  delete  the  entire  secret  key  database: 


switch : admin>  secAuthSecret  --remove  --all 

This  command  deletes  database  of  DH-CHAP  secret 

keys.   If  a  fabric 

requires  authentication,  deleting  this  database 

may  cause  switch 

to  segment  from  the  fabric . 

Do  want  to  remove  secret  key  database?   (yes,  y. 

no,   n)  :    [no]  y 

Deleting  secret  key  database...  Done. 

See  also 

autliUtil 
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secCertUtil 

Manages  third-party  PKI-based  certificates  in  the  switch. 

Synopsis 

seccertutil 

Availability 

admin 

Description 

Use  this  command  to  manage  third-party  certificates  in  the  switch.  The  command  can  be  used  to  do  the 
following: 

•  Generate  a  public/private  key  pair. 

•  Generate  a  certificate  signing  request  (CSR). 

•  Delete  a  CSR. 

•  List  the  certificates  present  in  the  switch. 

•  Display  the  contents  of  a  certificate/CSR. 

•  Delete  a  specific  certificate. 

•  Configure  SSL  certificate  file  name. 

•  Enable  secure  protocols. 

The  following  is  the  usage  statement  for  the  utility: 

seccertutil  delcsr  Delete  CSR 

seccertutil  delete  file  Delete  certificate 

name 

seccertutil  export  Export  CSR 

seccertutil  genkey  Generate  a  new  public/private  key  pair 

seccertutil  gencsr  Generate  a  new  CSR 

seccertutil  import   [-config  cacert]    |    [-config  swcert    [-enable  https]] 
Import  certificate 

config  swcert  Configure  SSL  certificate  filename  (optional) 

config  cacert  Configure  CA  certificate  filename  (optional) 

enable  https  Enable  secure  https  (optional) 

seccertutil  showcsr  Display  CSR  contents 

seccertutil  show  List  certificate 

seccertutil  show  file  name  Display  certificate  content 
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Operands 


The  operands  are  as  follows: 


delcsr 


genkey 


gencsr 


show 

certificate 


show 


showcsr 


Generates  a  public/private  key  pair.This  is  the  first  step  for  setting  up 
third-party  certificates.  The  key  length  can  be  either  1,024  or  2,048  bits  long. 
The  greater  the  length  of  the  key,  the  more  secure  is  the  connection;  however, 
the  performance  goes  down.  The  keys  are  generated  only  after  deleting 
existing  CSR  and  all  other  certificates. 

Generates  a  new  CSR  for  the  switch.  This  is  second  step  for  setting  up 
third-party  certificates  in  the  switch.  To  generate  a  CSR,  the  admin  must 
answer  a  series  of  questions  prompted  by  this  option.  Once  all  questions  are 
answered,  a  CSR  is  generated  and  placed  in  a  file  named 
ip_address .  csr.  The  ip_address  is  the  IP  address  of  the  switch. 

Deletes  the  CSR  in  the  switch. 

Displays  the  contents  of  the  CSR  in  the  switch. 

Displays  a  list  of  all  certificates  in  the  switch. 

Displays  the  contents  of  the  specified  certificate. 


name 


delete 
certificate 


Deletes  the  specified  certificate. 


name 


export 


Exports  a  CSR  to  a  host.  This  is  typically  used  to  submit  the  CSR  to  a  CA  who 
in  turn  issues  a  certificate. 


import      [-config  cacert]    |    [-config  swcert    [-enable  https]] 
Import  a  certificate  on  to  the  switch.  Use  this  for  the  following: 

•  Download  a  certificate  issued  by  a  CA  after  sending  the  CSR  to  the  CA. 

•  Download  an  Issuing  CA  certificate. 

•  Set  imported  certificate  with  -config  option.  Specifying  cacert  sets  the  CA  certificate  file  name  in 
configuration  and  specifying  swcert  sets  switch  certificate  file  name  in  configuration. 

•  Enable  secure  protocols  with  -enable  option.  This  option  can  be  used  only  with  -config  swcert. 


To  generate  a  public/private  key  pair: 

switch : adinin>  seccertutil  genkey 

Generating  a  new  key  pair  will  automatically  do  the  following: 

1.  Delete  all  existing  CSRs . 

2.  Delete  all  existing  certificates. 

3.  Reset  the  certificate  filename  to  none. 

4.  Disable  secure  protocols. 

Continue   (yes,   y,   no,   n) :    [no]  y 
Select  key  size   [1024  or  2048] : 
Generating  new  rsa  public/private  key  pair 
Done . 


Examples 
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To  generate  a  CSR: 

switch : admin>  seccertutil  gencsr 
Country  Name   (2  letter  code,   eg,   US) : 
State  or  Province  Name   (full  name,   eg,   California) : 
Locality  Name  (eg,   city  name) : 
Organization  Name   (eg,   company  name) : 

Organizational  Unit  Name   (eg,   department  or  section  name) : 
Common  Name   (Fully  qualified  Domain  Name,   or  IP  address) : 
generating  CSR,    file  name  is:   <ip_address> . csr 
Done 

To  delete  the  CSR: 

switch: admin>  seccertutil  delcsr 
WARNING ! ! ! 

About  to  delete  the  switch  CSR. 

ARE  YOU  SURE   (yes,   y,   no,   n) :    [no]  y 

To  import  a  certificate: 

switch : admin>  seccertutil  import 
Select  protocol    [ftp  or  scp] :  ftp 
Enter  IP  address:   ip  address 

Enter  remote  directory:   dir  name  where  certificate  is  stored 

Enter  certificate  name   (must  have  ".crt"  or  " .pem"   suffix):  filename 

Enter  Login  Name:  login 

Enter  Password:  password 

Success:   imported  certificate   [certificate  file  name]. 

To  import  a  certificate  with  configure  and  enable  option: 

switch : admin>  seccertutil  import  -config  swcert  -enable  https 
Select  protocol    [ftp  or  scp]:  ftp 
Enter  IP  address:   ip  address 

Enter  remote  directory:   dir  name  where  certificate  is  stored 

Enter  certificate  name   (must  have  ".crt"  or  ".pem"   suffix):  filename 

Enter  Login  Name:  login 

Enter  Password:  password 

Success:   imported  certificate   [certificate  file  name]. 
Certificate  file  in  configuration  has  been  updated. 
Secure  http  has  been  enabled. 

To  display  contents  of  a  CSR: 

switch : admin>  seccertutil  showcsr 
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To  display  contents  of  a  certificate: 

switch :adinin>  seccertutil  show  certificate  file  name 

See  also 

configure 
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secDefineSize 


Displays  the  size  of  the  defined  security  database. 


Synopsis 


secdef inesize 


Availability 


admin 


Description 


Use  this  command  to  display  the  size  of  the  active  security  database. 
The  maximum  size  is  256  KB. 

This  command  is  intended  strictly  for  debugging  purposes  by  technical  support  staff.  The  information 
displayed  might  not  be  supported  between  releases  and  is  subject  to  change  arbitrarily. 

[252)^  NOTE:    This  command  must  be  issued  from  a  sectelnet  or  SSH  session. 


Operands 


none 


Examples 


To  display  the  size  of  the  defined  security  database: 


switch : admin>  secdef inesize 


Size  of  security  defined  data:   35  bytes    (Max  262144  bytes) 


See  also 


secActiveSize 


secGlobalShow 
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secFabricShow 


Displays  security-related  fabric  information. 

Synopsis 

secf abricshow 

Availability 

all  users 

Description 

This  command  displays  tfie  security-related  information  about  the  fabric. 

The  information  displayed  is  as  follows: 

Role  Displays  whether  the  switch  is  the  primary  FCS,  backup  FCS,  or  not 

FCS. 

WWN  Displays  the  World  Wide  Name  of  the  switch. 

Did  Displays  the  domain  of  the  switch. 

Status  Displays  the  security  state  of  the  switch: 

Ready  -  This  switch  is  in  a  stable  state. 

Busy  -  This  switch  is  updating  its  security  database. 

Error  -  This  switch's  security  database  is  inconsistent  with  the  primary 

FCS. 

Enet  IP  Addr  Displays  the  Ethernet  IP  address. 

Name  Displays  the  switch  name. 

NoResp  Displays  if  the  switch  did  not  respond  to  the  status  query. 

Unknown  Displays  if  the  switch  is  in  an  unknown  state. 


NOTE:    This  command  must  be  issued  from  a  sectelnet  or  SSH  session. 

When  this  command  is  issued  on  multiple  switches  in  the  fabric,  one  or  more  of  these  switches  can  display 
a  status  of  busy. 


Operands 

none 

Examples 

To  display  security-related  fabric  information  on  the  primary  FCS  switch: 

switch :  adinin>  secf  abricshow 

Role        WWN  Did  Status    Enet  IP  Addr  Name 

non-FCS  10:00:00:60:69:10:03:23  1  Ready  192.168.100.148  "nonfcs" 
Backup  10:00:00:60:69:00:12:53  2  Ready  192.168.100.147  "backup" 
Primary  10 : 00 : 00 : 60 : 69 :22 : 32 : 83       3  Ready       192.168.100.135  "switch" 


Secured  switches  in  the  fabric:  3 


Fabric  OS  5.0.0  command  reference  guide  533 


See  also 

secPolicyDump 
secPolicyShow 
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secFCSFailover 


Enables  a  backup  PCS  switch  to  take  over  as  primary  PCS  switch. 

Synopsis 

sec fcsfai lover 

Availability 

admin 

Description 

Use  this  command  to  enable  a  backup  PCS  switch  to  take  over  as  the  primary  PCS  switch. 

This  command  can  be  issued  only  on  a  backup  PCS  switch.  After  this  command  is  issued,  the  primary  PCS 
switch  aborts  its  current  transaction  and  moves  the  backup  PCS  switch  to  the  top  of  the  PCS  list.  The  former 
primary  PCS  switch  then  activates  the  new  policy  set  and  the  former  backup  PCS  switch  becomes  the  new 
primary  PCS  switch  in  the  fabric. 

The  purpose  of  this  command  is  to  recover  from  a  scenario  in  which  all  available  access  to  the  primary 
PCS  switch  is  lost,  such  as  the  Ethernet  and  serial  connections. 

Operands 

none 


Examples 

To  enable  a  backup  PCS  switch  to  take  over  as  the  primary  PCS  switch: 

switch : ad[nin>  secf csf ailover 

This  switch  is  about  to  become  the  Primary  FCS  switch. 

All  transactions  of  the  current  Primary  FCS  switch  will  be  aborted. 

ARE  YOU  SURE     (yes,  y,   no,   n) :    [no]  y 

WARNING! ! ! 

The  FCS  policy  of  Active  and  Defined  Policy  sets  have  been  changed. 
Review  them  before  you  issue  secPolicyActivate  again. 


See  also 


secFabricShow 
secModeDi sable 


secModeShow 
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secGlobalShow 


Displays  the  current  internal  security  state  information. 

Synopsis 

secglobalshow 

Availability 

admin 

Description 

Use  this  command  to  display  security  server  (seed)  specific  information  as  a  snapshot  of  its  current  state. 
The  information  can  include  some  of  the  following: 

•  The  version  and  general  information 

•  The  current  status  of  the  RCS  transaction 

•  The  active  and  defined  sizes  of  the  security  database 

This  command  is  intended  strictly  for  debugging  purposes  by  technical  support  staff  only.  The  information 
displayed  might  not  be  supported  betv/een  releases  and  is  subject  to  change  arbitrarily. 

'—)f  NOTE:    This  command  must  be  issued  from  a  sectelnet  or  SSH  session. 


Operands 

none 

Examples 

To  view  the  current  security  state: 

switch :  ac3inin>  secglobalshow 

See  also 

secActiveSize 
secDef ineSize 
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secHelp 

Displays  information  about  security  commands. 

Synopsis 

sechelp 

Availability 

all  users 

Description 

Use  this  command  to  display  a  list  of  security  commands. 

Operands 

none 
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Examples 

To  display  a  list  of  security  telnet  commands: 


switch : admin>  sechelp 

pkiCreate 

Creates  new  pki  objects 

pkiRemove 

Removes  pki  objects 

pkiShow 

Displays  existence  of  pki  objects 

secActiveSize 

Displays  size  of  the  active   (security)  database 

secAuthSecret 

Creates/Manages/Displays  DHCHAP  secret  key  details 

secCertUtil 
certificates 

Creates/Manages/Displays  third  party  PKI 

secDef ineSize 

Displays  size  of  the  defined  (security)  database 

secFabricShow 

Displays  security  related  fabric  information 

secFCSFai lover 

Forces  primary  role  to  this  FCS  switch 

secGlobalShow 

Displays  current  internal  security  state  information 

s  ecModeEnabl e 

Enables  secure  mode 

secModeDi sable 

Disables  secure  mode 

secModeShow 

Displays  whether  secure  mode  is  enabled  or  disabled 

secNonFCSPasswd 

Sets  the  admin  passwd  for  non-FCS  switches 

secPolicyAbort 

Aborts  changes  to  defined  policy 

secPolicyActivate 

Activates  all  policy  sets 

secPolicyAdd 

Adds  members  to  an  existing  policy 

secPolicyCreate 

Creates  a  new  policy 

secPolicyDelete 

Deletes  an  existing  policy 

s  ec  Po 1 i  cyFCSMove 

Moves  a  member  in  the  FCS  policy 

secPolicyReitiove 

Removes  members  from  an  existing  policy 

secPolicySave 

Saves  defined  policy  set  and  sends  to  all  switches 

s  ec  Po 1 i  cyShow 

Shows  members  of  one  or  more  policies 

s ec Po 1 i cyDump 

Displays  all  members  of  existing  policies 

secStatsReset 

Resets  security  statistics 

secStatsShow 

Displays  security  statistics 

secTempPasswdSet 

Sets  temporary  password 

secTempPasswdReset 

Resets  temporary  password 

secTransAbort 

Aborts  current  transaction 

secVersionReset 

Resets  version  stamp 

See  also 

none 
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secModeDisable 

Disables  secure  mode. 

Synopsis 

secmodedi sable 

Availability 

admin 

Description 

Use  this  command  to  disable  secure  mode  on  all  switches  in  the  fabric.  This  command  deletes  both  the 
defined  and  active  security  database. 

This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  FCS  switch. 
Operands 

none 

Examples 

To  disable  security  mode: 


primaryf  cs  :  adinin>  secrtiodedisable 

Please  enter  current  admin  account 

password: 

Warning ! ! ! 

About  to  disable  security. 

ARE  YOU  SURE    (yes,   y,   no,   n) :  [no] 

Y 

See  also 

secFabricShow 


secModeShow 
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secModeEnable 

Enables  secure  mode. 

Synopsis 

secmodeenable   [ --quickmode]    |    [ [ --currentpwd]    [ --lockdown [ =scc  |=dcc]] 
[--fcs  list_of_switches   \  list_of_switches]] 

Availability 

admin 

Description 

Use  this  command  to  enable  secure  mode  on  all  switches  in  the  fabric.  This  command  fails  if  any  switch  in 
the  fabric  is  not  capable  of  enforcing  the  security  policies  defined  in  the  security  database.  If  no  operand 
is  specified,  the  command  becomes  interactive. 


NOTE:   This  command  must  be  issued  from  a  sectelnet  or  SSH  session  and  requires  a  security  license. 


This  command  sets  up  security  in  the  fabric  by: 

•  Activating  security  mode  on  all  switches  in  the  fabric. 

•  Creating  the  security  database,  populated  with  a  list  of  FCS  switches  in  the  FCS_POLICY. 

•  Distributing  the  security  database  to  all  switches  in  the  fabric. 

•  Resetting  the  root,  factory,  admin,  and  user  account  passwords  on  all  FCS  switches. 

•  Resetting  the  admin  and  user  account  passwords  on  all  non-FCS  switches. 

•  Disabling  the  root  and  factory  accounts  on  all  non-FCS  switches  in  the  fabric. 
The  administrator  is  prompted  to  enter  passwords  for  the  following  accounts: 


•  root 

•  admin 

•  user 

•  non-FCS  admin 

The  prompts  do  not  display  if  the  administrator  chooses  to  use  the  passwords  on  the  primary  FCS  with  the 
--currentpwd  option.  With  this  option,  the  admin  password  is  used  for  non-FCS  admin  as  well. 

If  the  fabric  is  not  in  secure  mode  and  one  or  more  specified  FCS  switches  is  present  in  the  fabric,  the 
command  must  be  issued  on  the  first  active  FCS  in  the  list. 

If  the  fabric  is  not  in  secure  mode  and  no  specified  FCS  switches  are  present  in  the  fabric,  the  command 
can  be  issued  on  any  switch.  Only  the  --fcs  option  can  be  used  in  this  case. 

If  the  fabric  is  not  in  secure  mode  and  this  command  is  issued,  the  switches  in  the  fabric  with  Fabric  OS 
versions  previous  to  v4.4.0  or  v3.2.0  reboots  automatically. 


factory 
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If  the  fabric  is  in  secure  mode  and  no  FCS  switches  are  present  in  the  fabric,  the  command  can  be  issued 
on  any  switch.  This  is  used  to  recover  a  secure  fabric  that  has  no  FCS  switch.  Only  the  --f  cs  option  can 
be  used  in  this  case. 


NOTE:  Ensure  that  all  users  (using  Fabric  OS  CLI  or  Web  Tools)  are  logged  off  the  fabric  before  enabling 
secure  mode;  otherwise,  users  on  non-FCS  switches  lose  their  telnet  sessions. 

A  maximum  of  80  WWNs  can  be  specified  in  the  FCS  policy  using  the  command.  To  add  more  WWNs 
use  the  secPolicyAdd  command. 


This  command  has  the  following  operands: 

1  is t_of_s witches      Specify  a  list  of  switches  for  the  FCS  policy.  The  list  of  switches  must 

be  enclosed  in  quotation  marks,  and  each  member  switch  must  be 
separated  from  the  others  by  semicolons.  The  members  can  be 
specified  using  domain,  WWN,  or  switch  name  format,  as  follows: 

"5;    10:00:00:60:69:00:00:20;  starl" 

If  a  member  is  specified  by  domain  or  switch  name,  the  switch  must 
be  in  the  fabric  or  the  command  fails. 

This  operand  is  optional.  If  no  operand  is  specified,  the  session 
becomes  interactive  and  you  are  prompted  to  enter  FCS  member 
values. 

Specify  a  list  of  switches  for  the  FCS  policy.  Specifying  "*"  defaults 
this  to  all  the  switches  currently  present  in  the  fabric.  If  a  member  is 
specified  by  domain  or  switch  name,  the  switch  must  be  in  the  fabric 
or  the  command  fails. 

If  the  list  of  FCS  switches  is  not  specified,  the  session  becomes 
interactive  and  the  user  is  prompted  to  enter  FCS  members. 

Use  the  current  passwords  of  the  switch  the  command  is  run  on  (the 
primary  FCS  switch)  for  root,  factory,  admin  and  user  accounts. 
Non-FCS  admin  account  password  is  set  the  same  as  FCS  admin 
account  password.  The  command  does  not  prompt  for  new 
passwords.  Only  sessions  whose  account  password  has  changed 
are  logged  out.  This  option  can  be  used  only  on  a  fabric  with  secure 
mode  disabled  and  only  when  the  command  is  run  on  the  switch 
specified  as  the  primary  FCS  switch. 

Create  SCC  and  DCC  policies  to  lockdown  the  fabric.  SCC  policy 
is  populated  with  all  the  switches  present  in  the  fabric  when  the 
command  is  executed.  DCC  policies  are  populated  with  the  devices 
present  in  the  fabric  when  the  command  is  executed,  locking  down 
devices  on  a  per  port  basis.  Ports  with  no  devices  attached  to  them 
also  are  locked  down  with  an  empty  DCC  policy  so  no  device  can 
be  connected  to  them,  preserving  the  fabric  as  is.  This  option  can  be 
used  only  on  a  fabric  with  secure  mode  disabled  and  only  when  the 
command  is  run  on  the  switch  specified  as  the  primary  FCS  switch. 


-f  cs 

list_of_swi tches 


--currentpwd 


--lockdown [=scc 
I =dcc] 
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--quickmode  This  option  is  a  shorthand  notation  for  a  combination  of  the 

--currentpwd,   --lockdown,   and  --fcs  "*"  options.  On 
successful  execution  of  the  command,  security  is  enabled  in  the 
fabric  with  all  switches  being  FCS,  all  switches  having  passwords 
identical  to  that  of  the  primary  FCS  and  SCC,  and  DCC  policies 
capturing  and  maintaining  the  current  configuration  of  the  fabric. 
This  option  can  be  used  only  on  a  fabric  with  secure  mode  disabled 
and  only  when  the  command  is  run  on  the  switch  specified  as  the 
primary  FCS  switch. 

If  no  operand  is  specified,  the  session  becomes  interactive  and  the  user  is  prompted  to  enter  FCS  switch 
members  and  passwords. 

If  the  -currentpwd  option  is  not  used,  the  session  becomes  interactive  and  the  user  is  prompted  to 
enter  new  passwords  for  root,  factory,  admin,  user,  and  non-FCS  admin  accounts. 

Examples 

To  enable  secure  mode  using  --quickmode: 

f csprimary : admin>  secModeEnable  --quickmode 

Your    use  of    the  certificate-based    security  features    of  the  software 

installed  on  this  equipment  is  subject  to  the  End  User  License  Agreement 

provided    with  the  equipment  and  the  Certification    Practices  Statement, 

which  you  may  review  at  http://www.switchkeyactivation.com/cps.  By 
using 

these  security  features,  you  are  consenting  to  be  bound  by  the  terms  of 
these  documents.  If  you  do  not  agree  to  the  terms  of  these  documents, 
promptly  contact  the  entity  from  which  you  obtained  this  software  and  do 
not  use  these  security  features. 

Do  you  agree  to  these  terms?     (yes,  y,   no,   n) :    [no]  y 

This  command  requires  Switch  Certificate,     Security  license  and  Zoning 
license  to  be  installed  on     every  switch  in  the  fabric. 

PLEASE  NOTE:   On  successful  completion  of  this  command,    login  sessions 
may  be  closed  and  some  switches  may  go  through  a  reboot  to  form  a  secure 
fabric . 

Non-FCS  admin  password  will  be  set  the  same  as  FCS  admin  password. 
ARE  YOU  SURE     (yes,   y,   no,   n) :    [no]  y 
Please  enter  current  admin  account  password: 
Secure  mode  is  enabled. 
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To  enable  a  security  policy  that  includes  three  FCS  switches  specified  by  domain,  WWN  address,  and 
switch  name: 

f csprimary : admin>  secmodeenable 

Your  use  of  the  certificate-based  security  features  of  the  software 
installed  on  this  equipment  is  subject  to  the  End  User  License  Agreement 
provided  with  the  equipment  and  the  Certification  Practices  Statement, 
which  you  may  review  at  http://www.switchkeyactivation.com/cps.  By  using 
these  security  features,  you  are  consenting  to  be  bound  by  the  terms  of 
these  documents.  If  you  do  not  agree  to  the  terms  of  these  documents, 
promptly  contact  the  entity  from  which  you  obtained  this  software  and  do 
not  use  these  security  features. 

Do  you  agree  to  these  terms?      (yes,  y,   no,   n) :    [no]  y 

This  command  requires  Switch  Certificate,     Security  license  and  Zoning 
license  to  be  installed  on     every  switch  in  the  fabric. 

PLEASE  NOTE:   On  successful  completion  of  this  command,    login  sessions 
may  be  closed  and  some  switches  may  go  through  a  reboot  to  form  a  secure 
fabric . 

This  is  an  interactive  session  to  create  a  FCS  list. 
The  new  FCS  list  is  empty. 

Enter  WWN,   Domain,   or  switch  name (Leave  blank  when  done) :  102 
Switch  WWN  is   10:00:00:60:69:80:04:0f . 

The  new  FCS  list: 
10:00:00:60:69:80:04:0f 

Enter  WWN,   Domain,   or  switch 
10:00:00:60:69:80:04:0e 
Switch  WWN  is  10:00:00:60:69 

The  new  FCS  list: 
10:00:00:60:69:80:04:0f 
10:00:00:60:69:80:04:0e 

(continued  on  next  page) 


name (Leave  blank  when  done) : 
:80:04:0e. 
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Enter  WWN,   Domain,   or  switch  name (Leave  blank  when  done) :  swl 
Switch  WWN  is  10:00:00:60:69:80:04:0a. 

The  new  FCS  list: 
10:00:00:60:69:80:04:0f 
10:00:00:60:69:80:04:0e 
10 : 00 : 00 : 60 : 69 : 80 : 04  :  Oa 

Enter  WWN,   Domain,   or  switch  name (Leave  blank  when  done) : 
Are  you  done?     (yes,   y,   no,   n) :    [no]  y 
Is  the  new  FCS  list  correct?     (yes,   y,   no,   n) :    [no]  y 
Please  enter  current  admin  account  password: 

Warning:  Access  to  the  Root  and  Factory  accounts  may  be  required  for 
proper  support  of  the  switch.  Please  ensure  the  Root  and  Factory 
passwords  are  documented  in  a  secure  location.  Recovery  of  a  lost  Root 
or  Factory  password  will  result  in  fabric  downtime. 

Changing  password  for  root 
New  FCS  switch  root  password: 
Re-type  new  password: 
(output  truncated) 
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To  enable  secure  mode  using  -currentpwd  -fcs 

switch : adinin>  f csprimary : admin>  secModeEnable  --currentpwd  --fcs  "*" 

Your    use  of    the  certificate-based    security  features    of  the  software 

installed  on  this  equipment  is  subject  to  the  End  User  License  Agreement 
provided    with  the  equipment  and  the  Certification    Practices  Statement, 
which  you  may  review  at  http://www.switchkeyactivation.com/cps.  By 
using 

these  security  features,  you  are  consenting  to  be  bound  by  the    terms  of 
these    documents.     If  you    do  not  agree  to  the  terms  of  these  documents, 

promptly  contact  the  entity  from  which  you  obtained  this  software  and  do 

not  use  these  security  features. 

Do  you  agree  to  these  terms?     (yes,   y,   no,   n) :    [no]  y 

This  command  requires  Switch  Certificate,     Security  license  and  Zoning 
license  to  be  installed  on     every  switch  in  the  fabric. 

PLEASE  NOTE:   On  successful  completion  of  this  command,    login  sessions 
may  be  closed  and  some  switches  may  go  through  a  reboot  to  form  a  secure 
fabric . 

Non-FCS  admin  password  will  be  set  the  same  as  FCS  admin  password. 
ARE  YOU  SURE     (yes,  y,   no,   n) :    [no]  y 

Please  enter  current  admin  account  password: 

Secure  mode  is  enabled. 

See  also 

secFabricSliow 
secModeDi sable 
secModeSlnow 
secPolicySliow 
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secModeShow 


Displays  whether  security  mode  is  enabled  or  disabled. 

Synopsis 

secmodeshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  security  mode  of  the  fabric.  The  fabric  can  be  in  secure  mode  or 
nonsecure  mode. 

The  command  displays  secure  mode  as  ENABLED  or  DISABLED.  If  the  fabric  is  in  secure  mode,  the 
following  information  displays: 

Version  stamp  Displays  the  current  version  and  build  date  and  time  of  the  security  database. 

PCS  switches  Displays  a  list  of  PCS  switches. 

Primary  Displays  whether  the  switch  is  a  primary  PCS  or  backup  PCS. 

WWN  Displays  the  WWN  of  the  PCS  switch. 

DID  Displays  the  domain  of  the  PCS  switch. 

swName  Displays  the  alias  name  of  the  PCS  switch. 

This  command  can  be  issued  on  any  switch  in  a  fabric. 

Operands 

none 

Examples 

To  display  the  current  security  mode  of  a  fabric: 

switch : admin>  secmodeshow 

Secure  Mode :  ENABLED . 

Version  Stamp:  9182,  Wed  Mar  17  16:37:01  2004. 
POS  Primary  WWN  Did  swName . 


1  Yes  10:00:00:60:69:00:00:5a  21   switch47 . 

2  No  12:00:00:60:60:03:23:5b  5     switchl2 . 


See  also 


secFabricShow 
secModeDi sable 
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secNonFcsPasswd 


Sets  the  admin  password  for  non-FCS  switches. 


Synopsis 

secnonf cspasswd 


Availability 

admin 

Description 

Use  this  command  to  change  the  admin  password  on  all  non-FCS  switches  in  the  fabric.  This  command 
can  be  issued  only  from  the  primary  PCS  switch  in  secure  mode.  The  changed  passwords  are  persistent 
across  reboots.  All  non-FCS  switches  that  join  the  fabric  in  the  future  inherit  this  new  password. 

The  password  must  be  between  8  and  40  characters  long  and  can  consist  of  any  combination  of 
alphanumeric  characters. 


[^^f  NOTE:   This  command  must  be  issued  from  a  sectelnet  or  SSH  session  and  can  be  issued  only  from  the 
primary  PCS  switch. 

Make  sure  no  users  are  logged  in  to  the  network  when  this  command  is  executed,  otherwise,  users  on 
non-FCS  switches  sessions  terminate. 


Operands 

none 

Examples 

To  set  the  admin  password  for  all  non-FCS  switches  in  the  fabric: 

switch  :adinin>  secnonf  cspasswd 
Changing  password  for  admin 
Non  FCS  switch  admin  password: 
Re-type  new  password: 


Login  sessions  with  password  changed  will  be  terminated. 
Password  for  non-FCS  admin  account  has  been  changed  successfully. 

See  also 

passwd 

secModeDi sable 


secModeShow 
secTempPasswdSet 
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secPolicyAbort 


Aborts  all  changes  to  the  defined  database  that  have  not  been  saved. 


secpolicyabort 


Description 

Use  this  command  to  abort  all  changes  to  the  defined  security  database  that  have  not  been  saved  to  flash 
memory. 


\^^)f  NOTE:    This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  FCS  sv/itch. 


Operands 

none 

Examples 

To  abort  all  changes  that  have  not  been  saved  to  flash  memory: 


primaryf  cs  :  adinin>  secpolicyabort 
Unsaved  data  has  been  aborted, 
primaryf cs : admin>  secpolicyabort 
No  new  data  to  abort . 


secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

s ecPo 1 i cyRemove 

secPolicySave 

secStatsShow 


Synopsis 


Availability 


admin 


See  also 
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secPolicyActivate 


Applies  defined  policy  set  to  all  switches  in  the  fabric. 


Synopsis 

secpolicyactivate 

Availability 

admin 

Description 

Use  this  command  to  activate  the  current  defined  security  policy  to  all  switches  in  the  fabric.  After 
activation,  the  defined  policy  set  becomes  the  active  policy  set. 


\^)f  NOTE:    This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  FCS  switch. 


Operands 

none 

Examples 

To  activate  the  defined  security  policy  set  to  all  switches  in  the  fabric: 


primaryf cs : adinin>  secpolicyactivate 

About  to  overwrite  the  current  Active  data. 

ARE  YOU  SURE   (yes,   y,   no,   n) :    [no]  y 

secpolicyactivate  command  was  completed  successfully. 


secPolicyAbort 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secPolicySave 

secStatsShow 


See  also 
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secPolicyAdd 

Adds  members  to  an  existing  policy. 

Synopsis 

secpolicyadd  name,  "member  [ ;  member...]" 

Availability 

admin 

Description 

Use  this  command  to  add  members  to  an  existing  access  policy.  The  new  members  must  not  already  be 
members  within  the  policy  or  the  command  fails. 

Each  policy  corresponds  to  a  management  method.  The  list  of  members  of  a  policy  acts  as  an  access 
control  list  for  that  management  method.  When  security  is  first  enabled  using  the  command,  only  the 
FCS_POLICY  exists.  Before  a  policy  is  created,  there  is  no  enforcement  for  that  management  method;  all 
access  is  granted.  After  a  policy  has  been  created  and  a  member  has  been  added  to  the  policy,  that 
policy  becomes  closed  to  all  access  except  from  included  members.  If  all  members  are  then  deleted  from 
the  policy,  all  access  is  denied  for  that  management  access  method  (the  DCC_POLICY  is  an  exception). 

[^^^  NOTE:    This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  PCS  switch. 
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Operands 


This  command  has  the  following  operands: 

name  Specify  the  name  of  an  existing  policy  to  which  you  want  to  add  members.  Valid  values 

for  this  operand  are: 

DCC_POLICY_nnn 

FCS_POLICY 

TELNET_POLICY 

HTTP_POLICY 

APLPOLICY 

RSNMP_POLICY 

WSNMP_POLICY 

SES_POLICY  (HP  does  not  support  SES_POLICY) 

MS_POLICY 

SERIALPOLICY 

FRONTPANELPOLICY 

SCC_POLICY 

OPTIONS_POLICY 

The  specified  policy  name  must  be  capitalized. 

The  DCC_POLICY_nnn  name  has  the  common  prefix  DCC_POLICY_  followed  by  a 
string  of  user-defined  characters.  These  characters  do  not  have  to  be  capitalized  like 
regular  policy  names,  but  they  are  case  sensitive. 

member  Specify  a  list  of  member  switches  for  the  security  policy.  The  members  must  be  enclosed 

in  quotation  marks  and  separated  by  semicolons.  Depending  on  the  policy  type, 
members  can  be  specified  using  IP  address,  WWN,  domain,  switch  name,  or  other. 

IP  Address  Member  Policy  Types 

The  following  policy  types  require  members  be  specified  by  IP  address: 

TELNET_POLICY 

HTTP_POLICY 

APLPOLICY 

RSNMP_POLICY 

WSNMP_POLICY 

These  policy  types  require  member  IPs  to  be  specified  in  dot  notation  (for  example, 
1  24.23.56.1  22).  If  0  is  specified  in  one  of  the  octets,  any  number  can  be  matched. 

WWN  Member  Policy  Types 
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The  following  policy  types  require  members  be  specified  by  WWN  address: 

•  FCS_POLICY 

•  SES_POLICY  (HP  does  not  support  SES_POLICY) 

•  MS_POLICY 

•  SERIALPOLICY 

•  FRONTPANELPOLICY 

•  SCC_POLICY 

Tfiese  policy  types  require  members  be  specified  as  WWN  strings,  domain  IDs,  or 
switch  names.  If  domain  ID,  or  switch  names  are  used,  the  switches  associated  must  be 
present  in  the  fabric  or  the  command  fails. 

DCC_POLICY  Members 

The  DCC_POLICY_nnn  is  a  list  of  devices  associated  with  a  specific  switch  and  port 
combination.  An  empty  DCC_POLICY  does  not  stop  access  to  the  switch.  The  device  is 
specified  with  a  WWN  string.  The  switch  and  port  combination  must  be  in  the 
following  format: 

<switch><port> 

<switch>  can  be  specified  using  WWN,  domain,  or  switch  name. 

<port>  can  be  specified  by  port  numbers  separated  by  commas  and  enclosed  in 
either  brackets  or  parenthesis:  for  example,  (2,  4,  6).  Ports  enclosed  in  brackets  will 
include  the  devices  currently  attached  to  those  ports. 

The  following  examples  illustrate  several  ways  to  specify  the  port  values: 

(1-6)        Selects  ports  1  through  6. 

(*)  Selects  all  ports  on  the  switch. 

[3,  9]       Selects  ports  3  and  9  and  all  devices  attached  to  those  ports. 

[1-3,  5]    Selects  ports  1  through  3  and  5  and  all  devices  attached  to  those  ports. 

[*]  Selects  all  ports  on  the  switch  and  devices  currently  attached  to  those  ports. 

OPTIONS_POLICY  members 

NoNodeWWNZoning  is  the  only  option 

Examples 

To  add  a  member  to  the  MS_POLICY  using  the  device  WWN: 


switch: admin>  secpolicyadd  "MS_POLICY" ,  "12 

24:45:10:0a:67:00:40" 

Member (s)  have  been  added  to  MS_P0LICY. 

To  add  an  SNMP  manager  to  WSNMP_POLICY: 

switch: admin>  secpolicyadd  "WSNMP_POLICY" , 

'192  . 168 .5.21" 

Member (s)  have  been  added  to  WSNMP_P0LICY. 
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To  add  two  devices  to  attach  to  domain  3,  ports  1  and  3,  in  an  existing  empty  DCC  policy;  port  WWN  of 
the  first  device  is  1 1 :22:33:44:55:66:77:aa  and  port  WWN  of  the  second  device  is 
ll:22:33:44:55:66:77:bb: 

switch : adinin>  secpolicyadd  " DCC_POLICY_abc " , 
"ll:22:33:44:55:66:77:aa;ll:22:33:44:55:66:77:bb;3(l,3)" 

Member (s)  have  been  added  to  DCC_POLlCY_abc . 
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See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secPolicySave 

secStatsShow 
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secPolicyCreate 

Creates  a  new  policy. 

Synopsis 

secpolicycreate  name   [,  "member  [; member. . .]" 


Availability 

admin 

Description 

Use  this  command  to  create  a  new  policy.  All  policies  can  be  created  only  once,  except  for  the 
DCC_POLICY_nnn.  Each  DCC_POLICY_nnn  must  each  have  a  unique  name. 

Adding  members  while  creating  a  policy  is  optional.  You  can  add  members  to  a  policy  later,  using  the 

secPolicyAdd  command. 

Each  policy  corresponds  to  a  management  method.  The  list  of  members  of  a  policy  acts  as  an  access 
control  list  for  that  management  method.  When  security  mode  is  first  enabled  using  the  command,  only 
the  FCS_POLICY  exists.  Before  a  policy  is  created,  there  is  no  enforcement  for  that  management  method; 
all  access  is  granted.  After  a  policy  has  been  created  and  a  member  has  been  added  to  the  policy,  that 
policy  becomes  closed  to  all  access  except  from  included  members.  If  all  members  are  then  deleted  from 
the  policy,  all  access  is  denied  for  that  management  access  method. 


[^^}f  NOTE:    The  FCS_POLICY  can  only  be  created  when  enabling  security  mode  using  the  command. 
Lfl    if  a  TELNET_POLICY  or  SERIAL  POLICY  is  created,  that  ends  the  current  sectelnet  or  serial  session  and  a 
warning  is  issued. 

This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  PCS  switch. 
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Operands 

This  command  has  the  following  operands: 

name  Specify  the  name  of  a  policy  you  want  to  create.  Valid  values  for  this  operand  are: 

•  DCC_POLICY_nnn 

•  TELNET_POLICY 

•  HTTP_POLICY 

•  APLPOLICY 

•  RSNMP_POLICY 

•  WSNMP_POLICY 

•  SES_POLICY  (HP  does  not  support  SES_POLICY) 

•  MS_POLICY 

•  SERIALPOLICY 

•  FRONTPANELPOLICY 

•  SCC_POLICY 

•  OPTIONS_POLICY 

The  specified  policy  name  must  be  capitalized. 

The  DCC_POLICY_nnn  name  has  the  common  prefix  DCC_POLICY_  followed  by  a  string 
of  user-defined  characters.  These  characters  do  not  have  to  be  capitalized  like  regular 
policy  names.  Valid  values  for  DCC_POLICY_nnn  are  user  defined  alphanumeric  or 
underscore  characters.  The  maximum  length  is  30  characters,  including  the  prefix 
DCC_POLICY_. 

member  Specify  a  list  of  members  for  the  security  policy.  The  members  must  be  enclosed  in 

quotation  marks  and  separated  by  semicolons.  Depending  on  the  policy  type,  members 
can  be  specified  using  IP  address,  WWN,  domain,  or  switch  name. 

IP  Address  Member  Policy  Types 

The  following  policy  types  require  members  be  specified  by  IP  address: 

•  TELNET_POLICY 

•  HTTP_POLICY 

•  APLPOLICY 

•  RSNMP_POLICY 

•  WSNMP_POLICY 

These  policy  types  require  member  IDs  in  dot  notation  (for  example,  1 24.23.56.1  22).  If 
0  is  specified  in  one  of  the  octets,  any  number  can  be  matched. 
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WWN  Member  Policy  Types 

The  following  policy  types  require  members  be  specified  by  WWN  address: 

SES_POLICY  (HP  does  not  support  SES_POLICY) 

MS_POLICY 

SERIALPOLICY 

FRONTPANELPOLICY 

These  policy  types  require  member  IDs  be  specified  as  WWN  strings,  domains,  or 
switch  names.  If  domain,  or  switch  names  are  used,  the  switches  associated  must  be 
present  in  the  fabric  or  the  command  fails. 

DCC_POLICY  Members 

The  DCC_Policy_nnn  is  a  list  of  devices  associated  with  a  specific  switch  and  port 
combination.  The  device  is  specified  with  a  WWN  string.  The  switch  and  port 
combination  must  be  in  the  following  format: 

<switch><port> 

<switch>  can  be  specified  using  WWN,  domain,  or  switch  name. 

<port>  can  be  specified  by  port  numbers  separated  by  commas  and  enclosed  in  either 
brackets  or  parenthesis:  for  example,  (2,  4,  6).  Ports  enclosed  in  brackets  will  include  the 
devices  currently  attached  to  those  ports. 

The  following  examples  illustrate  several  ways  to  specify  the  port  values: 
(1-6)         Selects  ports  1  through  6. 
(*)  Selects  all  ports  on  the  switch. 

[3,  9]        Selects  ports  3  and  9  and  all  devices  attached  to  those  ports. 

[1-3,  5]     Selects  ports  1  through  3  and  5  and  all  devices  attached  to  those  ports. 

[*]  Selects  all  ports  on  the  switch  and  devices  currently  attached  to  those  ports. 

OPTIONS_POLICY  members 

NoNodeWWNZoning  is  the  only  option. 
SCC_POLICY  Members 

This  policy  type  requires  member  IDs  to  be  specified  as  WWN  strings,  domains,  or 
switch  names.  If  domain  or  switch  names  are  used,  the  switches  associated  must  be 
present  in  the  fabric  or  the  command  fails. 

To  add  all  switches  in  the  current  fabric  as  members  of  the  SCC_POLICY,  enter  an 
asterisk  (*)  as  the  member  value.  This  feature  cannot  be  used  by  the  other  security  telnet 
commands. 


Examples 


To  create  a  new,  single  MS_POLICY  that  enables  access  through  a  device  that  has  WWN  of 
1 2:24:45: 10:0a:67:00:40.: 

switch :adinin>  secpolicycreate  "MS_POLICY" ,    " 12 : 24 : 45 : 10 : Oa : 67 : 0 0 : 40 " 
MS_P0LICY  has  been  created. 
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To  create  a  new  front  panel  policy  that  only  enables  domains  3  and  4  to  use  the  front  panel: 


switch:  ac3inin>  secpolicycreate  "FRONTPA]SIEL_POLICY"  ,    "3;  4" 
FR0NTPANEL_P0LICY  has  been  created. 

To  create  a  device  policy  to  allow  two  devices  to  attach  to  domain  3  ports  1  and  3  (the  WWN  of  first 
device  is  1 1 :22:33:44:55:66:77:aa  and  the  WWN  of  second  device  is  1 1 :22:33:44:55:66:77:bb): 

switch: admin>  secpolicycreate  "DCC_P0LICY_aB_7 " , 
"ll:22:33:44:55:66:77:aa;ll:22:33:44:55:66:77:bb;3[l,3]  ■' 

DCC_POLlCY_abc  has  been  created. 

To  create  a  telnet  policy  to  allow  anyone  on  the  192.168.5.0/24  network  to  access  the  fabric  through 
sectelnet: 


switch: 

admin> 

secpolicycreate  "TELNET_P0LICY" , 

"192.168.5.0" 

TELNET, 

.POLICY 

has  been  created. 

See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyDelete 

secPolicyDump 

s ecPo 1 i cyRemove 

secPolicySave 

secStatsShow 
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secPol  icy  Delete 


Deletes  an  existing  policy. 


Synopsis 

secpolicydelete "name 

Availability 

admin 

Description 

Use  this  command  to  delete  an  existing  defined  policy.  The  FCS_POLICY  cannot  be  deleted  through  this 
command,  since  this  policy  must  exist  to  maintain  security  mode. 

Each  policy  corresponds  to  a  management  method.  The  list  of  members  of  a  policy  acts  as  an  access 
control  list  for  that  management  method.  When  security  mode  is  first  enabled  using  the  command,  only 
the  FCS_POLICY  exists.  Before  a  policy  is  created,  there  is  no  enforcement  for  that  management  method; 
all  access  is  granted.  After  a  policy  has  been  created  and  a  member  has  been  added  to  the  policy,  that 
policy  becomes  closed  to  all  access  except  from  included  members.  If  the  policy  is  deleted  all  access  is 
granted. 


f^f  NOTE:   This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  FCS  switch. 
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Operands 

This  command  has  the  following  operand: 

name  Specify  the  name  of  a  security  policy  to  delete.  The  policy  name  must  be  enclosed  in 

quotation  marks.  Valid  security  policy  names  are: 

DCC_POLICY_nnn 

TELNET_POLICY 

HTTP_POLICY 

APLPOLICY 

RSNMP_POLICY 

WSNMP_POLICY 

SES_POLICY  (HP  does  not  support  SES_POLICY) 
MS_POLICY 
SERIALPOLICY 
FRONTPANELPOLICY 
SCC_POLICY 
OPTIONS_POLICY 

The  specified  policy  name  must  be  capitalized. 

The  DCC_POLICY_nnn  name  has  the  common  prefix  DCC_POLICY_  followed  by  a  string 
of  user  defined  characters.  These  characters  do  not  have  to  be  capitalized  like  regular 
policy  names. 

This  operand  is  required. 

NOTE:   After  security  policy  is  deleted,  fabric-wide  switch  access  through  that  method  is  unrestricted. 
Examples 

To  delete  an  existing  security  policy: 


switch:  ac3inin>  secpolicydelete  "MS_ 

_POLICY" 

About  to  delete  policy  MS_P0LICY. 

Are  you  sure   (yes,   y,   no,   n) : [no] 

Y 

MS_P0LICY  has  been  deleted. 

See  also 

secPolicyAbort 
secPolicyActivate 
secPolicyAdd 
secPolicyCreate 
s e c P o 11 cy Dump 
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secPolicyRemove 

secPolicySave 

secStatsShow 
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secPol  icy  Dump 


Displays  all  members  of  existing  policies. 


Synopsis 

secpolicydump   [listtype[,  name]] 

Availability 

all  users 

Description 

Use  this  command  to  display,  without  page  breaks,  the  members  of  an  existing  policy  in  the  active  and 
defined  (saved)  databases. 


"25^)f  NOTE:    This  command  can  be  issued  only  i  secure  mode  but  from  any  primary  FCS  switch. 


Operands 


This  command  has  the  following  operands: 

list type 


name 


Specify  which  database  to  display.  The  name  for  active  database  is  Active;  the  name 
for  saved,  defined  database  is  Defined.  If  not  specified,  all  databases  are  displayed. 

Specify  the  name  of  a  security  policy  you  would  like  to  display.  Valid  values  for  this 
operand  are: 

DCC_POLICY_nnn 

FCS_POLICY 

TELNET_POLICY 

HTTP_POLICY 

APLPOLICY 

RSNMP_POLICY 

WSNMP_POLICY 

SES_POLICY  (HP  does  not  support  SES_POLICY) 
MS_POLICY 
SERIALPOLICY 
FRONTPANELPOLICY 
SCC_POLICY 
OPTIONS_POLICY 
The  specified  policy  name  must  be  capitalized. 

The  DCC_POLICY_nnn  name  has  the  common  prefix  DCC_POLICY_  followed  by  a 
string  of  user  defined  characters.  These  characters  do  not  have  to  be  capitalized  like 
regular  policy  names.  This  operand  is  optional. 
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Examples 

To  display  all  security  policy  information  from  all  databases  (active,  updating,  and  defined),  without  page 
breaks: 

primaryf  cs  :  adinin>  secpolicydump 


DEFINED  POLICY  SET 

FCS_POLICY 

Pos       Primary  WWN  Did  swName 


1       Yes  10:00:00:60:69:30:15:5c        1  primaryf CS 

HTTP_POLICY 
IpAddr 


192  . 155  .  52  .  0 


ACTIVE   POLICY  SET 

FCS_POLICY 

Pes       Primary  WWN  Did  swName 


1       Yes  10:00:00:60:69:30:15:5c       1  primaryf CS 

HTTP_POLICY 
IpAddr 


192 . 155 . 52  .  0 
192.155.53.1 
192.155.54.2 
192.155.55.3 


To  display  all  security  policy  information  for  the  TELNET_POLICY,  without  page  breaks: 

primaryf CS : admin>  secpolicydump  "*",  "TELNET_POLICY" 
DEFINED  POLICY  SET 

TELNET_POLICY 

IpAddr 

192 . 155 . 52 . 13 
192 . 155 . 52 . 11 


ACTIVE   POLICY  SET 


TELNET_POLICY 
IpAddr 


192  . 155 . 52 . 0 
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See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyRemove 

secPolicySave 

secStatsShow 
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secPolicyFCSMove 

Moves  a  member  in  the  FCS  policy. 

Synopsis 

secpolicyf csmove   [from,  to] 

Availability 

admin 

Description 

Use  this  command  to  move  an  FCS  member  from  one  position  to  another  in  the  FCS  list.  Only  one  FCS 
can  be  moved  at  a  time.  The  first  FCS  sv/itch  in  the  list  that  is  also  present  in  the  fabric  is  the  primary  FCS. 

If  no  parameters  are  specified,  the  command  becomes  interactive,  prompting  you  to  supply  valid  values 
for  the  operands. 


NOTE:    This  command  can  be  issued  only  from  secure  mode  and  only  from  the  primary  FCS  sv/itch. 
C— I    If  a  backup  FCS  is  moved  to  the  first  position,  it  becomes  the  primary  FCS  after  activation. 


Operands 

This  command  has  the  follov/ing  operands: 

from  Specify  the  position  of  the  FCS  switch  you  want  to  move. 

to  Specify  the  position  to  which  you  want  to  move  the  FCS  switch. 

If  no  operand  is  specified,  the  command  becomes  interactive  and  you  are  prompted  for  values. 
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Examples 

To  move  the  backup  FCS  switch  at  position  2  to  position  3  in  the  FCS  list: 


switch: admin>  secpolicyf csmove 

Pos       Primary  WWN 

Did  swName . 

1        Yes  10:00:00:60:69:10:02:18 

1  switch5 . 

2        No  10:00:00:60:69:00:00:5a 

2  switcheo. 

3       No  10:00:00:60:69:00:00:13 

3  switch73. 

Please  enter  position  you'd  like  to  move  from     :  (1..3) 

[1]  2 

Please  enter  position  you'd  like  to  move  to     :    (1..3)  [ 

1]  3 

DEFINED  POLICY  SET 

FCS_POLICY 

Pos       Primary  WWN 

Did  swName 

1       Yes  10:00:00:60:69:10:02:18 

1  switch5 . 

2       No  10:00:00:60:69:00:00:13 

3  switch73. 

3        No  10:00:00:60:69:00:00:5a 

2  switcheo. 

See  also 

secFabricShow 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secPolicySave 

secStatsShow 
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secPol  icy  Remove 


Removes  members  from  an  existing  policy. 

Synopsis 

secpolicyremove  name   [,   "member  [/member]" 

Availability 

admin 

Description 

Use  this  command  to  remove  members  from  an  existing  security  policy.  If  a  policy  is  empty  after  removing 
all  members,  all  accesses  to  the  policy  are  disallov/ed  (the  DCC_POLICY  and  OPTIONS_POLICY  are 
exceptions).  You  cannot  remove  all  members  from  FCS_POLICY,  and  you  cannot  remove  the  PCS  members 
from  SCC_POLICY. 

'2^^  NOTE:   This  command  can  be  issued  only  from  secure  mode  and  only  from  the  primary  PCS  sv/itch.. 


Operands 

This  command  has  the  follov^ing  operands: 

name  Specify  the  name  of  an  existing  policy  you  want  to  remove  members  from.  Valid  values 

for  this  operand  are:DCC_POLICY_nnn 

FCS_POLICY 

TELNET_POLICY 

HTTP_POLICY 

APLPOLICY 

RSNMP_POLICY 

WSNMP_POLICY 

SES_POLICY  (HP  does  not  support  SES_POLICY) 

MS_POLICY 

SERIALPOLICY 

FRONTPANELPOLICY 

SCC_POLICY 

OPTIONS_POLICY 

The  specified  policy  name  must  be  capitalized. 

The  DCC_POLICY  policy  name  has  the  common  prefix  DCC_POLICY_  followed  by  a 
string  of  user  defined  characters.  These  characters  do  not  have  to  be  capitalized  like 
regular  policy  names,  but  are  case  sensitive.This  operand  is  required. 
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member  Specify  a  member  or  list  of  members  to  delete  from  the  policy.  The  members  must  be 

enclosed  in  quotation  marks  and  separated  by  semicolons.  This  operand  is  required. 
Depending  on  the  policy  type,  members  can  be  specified  using  IP  address,  WWN, 
domain,  or  switch  name. 

IP  address  member  policy  types 

The  following  policy  types  require  members  be  specified  by  IP  address: 
TELNET_POLICY 
HTTP_POLICY 
APLPOLICY 
RSNMP_POLICY 
WSNMP_POLICY 

These  policy  types  require  member  IDs  in  dot  notation  (for  example,  124.23.56.122). 
If  0  is  specified  in  one  of  the  octets,  it  means  any  number  can  be  matched. 

WWN  member  policy  types 

The  following  policy  types  require  members  be  specified  by  WWN  address: 
FCS_POLICY 

SES_POLICY  (HP  does  not  support  SES_POLICY) 
MS_POLICY 
SERIALPOLICY 
FRONTPANELPOLICY 
SCC_POLICY 

These  policy  types  require  member  IDs  be  specified  as  WWN  strings,  domains,  or 
switch  names.  If  domain  or  switch  names  are  used,  the  switches  associated  must  be 
present  in  the  fabric  or  the  command  fails. 

DCC_POLICY  members 

The  DCC_Policy_nnn  is  a  list  of  devices  associated  with  a  specific  switch  and  port 
combination.  The  device  is  specified  with  a  WWN  string.  The  switch  and  port 
combination  must  be  specified  in  the  following  format: 

<switch><port> 

<switch>  can  be  specified  using  WWN,  domain,  or  switch  name. 

<port>  can  be  specified  by  port  number  separated  by  commas,  and  enclosed  in 
either  brackets  or  parenthesis:  for  example,  (2,  4,  6).  Ports  enclosed  in  brackets  will 
include  the  devices  currently  attached  to  those  ports.  The  following  examples  illustrate 
several  ways  to  specify  the  port  values: 

The  following  examples  illustrate  several  ways  to  specify  the  port  values: 
(1-6)         Selects  ports  1  through  6. 
(*)  Selects  all  ports  on  the  switch. 

[3,  9]       Selects  ports  3  and  9  and  all  devices  attached  to  those  ports. 
[1-3,  5]     Selects  ports  1  through  3  and  5  and  all  devices  attached  to  those  ports. 
[*]  Selects  all  ports  on  the  switch  and  devices  currently  attached  to  those  ports. 


568   Fabric  OS  commands 


OPTIONS_POLICY  members 

NoNodeWWNZoning  is  the  only  option. 

Examples 

To  remove  a  member  that  has  a  WWN  of  1  2:24:45:1 0:0a:67:00:40  from  MS  policy: 

switch:admin>  secpolicyremove  "MS_POLICY" ,  " 12 : 24 : 45 : 10 : Oa : 67 : 0 0 : 40 " 
Member ( s )   have  been  removed  from  MS_POLICY. 

See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicySave 

secStatsShow 
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secPolicySave 

Saves  a  defined  security  policy  to  flash  memory  on  all  switches  in  the  fabric. 

Synopsis 

secpolicysave 

Availability 

admin 

Description 

Use  this  command  to  save  a  defined  security  policy  to  flash  memory  of  all  switches  in  the  fabric. 
"25^  NOTE:    This  command  can  be  issued  only  from  secure  mode  and  only  from  the  primary  FCS  switch. 


Operands 

none 

Examples 

To  save  new  policy  set  in  all  switches  in  the  fabric: 

switch: admin>  secpolicysave 

secpolicysave  command  was  completed  successfully. 

See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secStatsShow 


570   Fabric  OS  commands 


secPolicyShow 

Displays  an  existing  security  policy. 

Synopsis 

secpolicyshow   [listtype[,  name]] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  members  of  an  existing  policy  in  the  active  or  defined  security  policy 
database.  Users  can  specify  which  database  to  display.  If  a  database  is  not  specified,  all  databases  are 
displayed. 

Users  can  specify  to  view  a  security  policy  by  name.  If  no  name  is  specified,  all  policies  are  displayed. 

This  command  displays  the  policy  database  one  page  at  a  time.  Use  to  display  the  policy  database 
without  page  breaks. 


[^^f  NOTE:  This  command  can  be  executed  on  any  FCS  switch  in  fabric,  but  it  must  be  issued  from  a  sectelnet 
li— I    or  SSH  session. 


Operands 

This  command  has  the  following  operands: 

listtype  Specify  which  database  to  display.  The  name  for  active  database  is  Active;  the 

name  for  saved,  defined  database  is  Defined.  This  operand  must  be  enclosed  in 
quotation  marks.  If  not  specified,  all  databases  are  displayed.  This  operand  is 
optional.  Use  an  asterisk  (*)  to  specify  both  active  and  defined. 

name  Specify  the  name  of  an  existing  policy  you  want  to  remove  members  from.  Valid 

values  for  this  operand  are:DCC_POLICY_nnn 

•  FCS_POLICY 

•  TELNET_POLICY 

•  HTTP_POLICY 

•  APLPOLICY 

•  RSNMP_POLICY 

•  WSNMP_POLICY 

•  SES_POLICY  (HP  does  not  support  SES_POLICY) 

•  MS_POLICY 

•  SERIALPOLICY 

•  FRONTPANELPOLICY 

•  SCC_POLICY 

•  OPTIONS_POLICY 
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The  specified  policy  name  must  be  capitalized. 

The  DCC_POLICY_nnn  name  has  the  common  prefix  DCC_POLICY_  followed  by  a 
string  of  user  defined  characters.  These  characters  do  not  have  to  be  capitalized 
like  regular  policy  names,  but  is  case  sensitive.  This  operand  is  optional. 

Examples 

To  display  all  security  policies  from  active  databases: 


switch : admin>  secpolicyshow  ' 

' active " 

ACTIVE  POLICY 

SET 

FCS_POLICY 

Pos       Primary  WWN 

Did 

swName 

1        Yes  10:00:00:60: 

:69:30:15: 

:  5c  1 

primaryf cs 

HTTP_POLICY 
IpAddr 

192 . 155 . 52  .  0 

To  display  all  security  policies  from  defined  databases: 


switch : admin> 

secpolicyshow  "defined" 

DEFINED  POLICY  SET 

FCS_POLICY 

Pos       Primary  WWN 

Did 

swName 

1  Yes 

10:00:00:60:69:30:15: 

:  5c  1 

primaryf cs 

HTTP_POLICY 

IpAddr 

192 . 155  .  52  , 

.  0 

192.155.53, 

.  1 

192 . 155 . 54 , 

.2 

192.155.55. 

.3 

192.155.56, 

.4 

See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secPolicySave 


572   Fabric  OS  commands 


secStats  Reset 

Resets  one  or  all  security  statistics  to  0. 

Synopsis 

secstatsreset   [name]  [,list] 

Availability 

admin 

Description 

Use  this  command  to  reset  one  or  all  security  statistics  to  0.  This  command  can  be  issued  to  any  switch.  If 
issued  on  the  primary  FCS  switch,  this  command  can  reset  security  statistics  for  any  or  all  switches  in  the 
fabric. 

Operands 

This  command  has  the  following  operands: 
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name 


list 


Specify  the  name  of  a  security  statistic  you  would  like  to  reset.  If  executed 
on  the  primary  FCS,  specify  an  asterisk  (*)  to  represent  all  security  policies. 
Valid  values  for  this  operand  are: 

TELNET_POLICY 

HTTP_POLICY 

APLPOLICY 

RSNMP_POLICY 

WSNMP_POLICY 

SES_POLICY  (HP  does  not  support  SES_POLICY) 

MS_POLICY 

SERIALPOLICY 

FRONTPANELPOLICY 

SCC_POLICY 
DCC_POLICY 

LOGIN 

INVALID_TS 

INVALID_SIGN 

INVALID_CERT 

SLAP  FAIL 

SLAP_BAD_PKT 

TS_OUT_SYNC 

NOJCS 

INCOMP_DB 

ILLEGAL_CMD 

The  specified  policy  name  must  be  all  capitalized. 

To  access  DCC  policies,  enter  DCC_POLICY.  Violations  are  not  tracked  for 
individual  DCC  policies.  The  statistics  for  all  DCC_POLICY  violations  are 
grouped  together. 

This  operand  is  optional  and  the  default  is  all  statistics.  If  the  list 
operand  is  specified,  this  operand  is  required. 

Specify  a  list  of  domains  on  which  to  reset  the  security  statistics.  Specify  an 
asterisk  (*)  to  represent  all  switches  in  the  fabric  or  specify  a  list  of 
domains,  separated  by  semicolons.  This  operand  is  optional  and  the 
default  value  is  the  local  switch. 
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Examples 

To  reset  all  statistics  on  the  local  switch: 

switch :adinin>  secstatsreset 
About  to  reset  all  security  counters. 
Are  you  sure   (yes,   y,   no,   n) : [no]  y 
Security  statistics  reset  to  zero. 

To  reset  DCC_POLICY  statistics  on  domains  1  and  69: 

switch :acainin>  secstatsreset  "DCC_POLICY"  ,  "1;69" 
Reset  DCC_P0LICY  statistic. 

See  also 

secFabricShow 
secStatsShow 
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secStatsShow 


Displays  one  or  all  security  statistics. 

Synopsis 

secstatsshow   [name]  [,  list] 

Availability 

admin 

Description 

Use  this  command  to  display  one  or  all  security  statistics.  This  command  can  be  issued  to  any  switch.  If 
issued  on  the  primary  FCS  switch,  this  command  can  retrieve  and  display  the  security  statistics  for  any  or 
all  switches  in  the  fabric. 


r2^^  NOTE:  This  command  displays  security  policy  statistics  in  secure  mode.  In  nonsecure  mode,  it  only 
li— I    reports  login  statistics. 


576   Fabric  OS  commands 


Operands 

This  command  has  the  following  operands: 

name  Specify  the  name  of  a  security  statistic  you  would  like  to  view.  If  executed  on  the 

primary  FCS,  specify  an  asterisk  (*)  to  represent  all  security  policies.  Valid  values  for 
this  operand  are: 

•  ELNET_POLICY 

•  HTTP_POLICY 

•  APLPOLICY 

•  RSNMP_POLICY 

•  WSNMP_POLICY 

•  SES_POLICY  (HP  does  not  support  SES_POLICY) 

•  MS_POLICY 

•  SERIALPOLICY 

•  FRONTPANELPOLICY 

•  SCC_POLICY 

•  DCC_POLICY 

•  LOGIN 

•  INVALIDJS 

•  INVALID_SIGN 

•  INVALID_CERT 

•  SLAP  FAIL 

•  SLAP_BAD_PKT 

•  TS_OUT_SYNC 

•  NO_FCS 

•  INCOMP_DB 

•  ILLEGAL_CMD 

The  specified  policy  name  must  be  all  capitalized. 

To  access  DCC  policies,  enter  DCC_POLICY.  Violations  are  not  tracked  for  individual 
DCC  policies.  The  statistics  for  all  DCC_POLICY  violations  are  grouped  together. 

This  operand  is  optional  and  the  default  is  all  statistics.  If  the  list  operand  is 
specified,  then  this  operand  is  required. 

list  Specify  a  list  of  domains  to  display  the  security  statistics  on.  Specify  an  asterisk  (*)  to 

represent  all  switches  in  the  fabric  or  specify  a  list  of  domains  separated  by 
semicolons.  This  operand  is  optional  and  the  default  value  is  the  local  switch. 
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Examples 

To  display  the  MS_POLICY  statistics  on  the  local  switch: 

switch: admin>  secstatsshow  "MS_POLICY" 
Name  Value 


MS  2  0 

To  display  statistic  information  for  TELNET_POLICY  for  all  switches  in  the  fabric: 


switch: admin>  secstatsshow  " TELNET_POLICY" , 

II  *  II 

Fabric  Statistics: 

Domain  1 : 

Name  Value 

TELNET_POLICY  0 

Domain  69: 

Name  Value 

TELNET_POLICY  0 

Domain  70: 

Name  Value 

TELNET_POLICY  0 

See  also 

secFabricShow 
secStatsReset 
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secTem  pPasswd  Reset 


Resets  a  temporary  password  on  a  remote  switch. 


Synopsis 

sectemppasswdreset   [domainl,   " login_nanie" ]  ] 

Availability 

admin 

Description 


Use  this  command  to  remove  temporary  passwords  that  were  set  up  using  secTempPasswdSet 


If  a  login  name  is  not  supplied,  all  passwords  on  the  switch  identified  by  the  specified  domain  are 
refreshed.  If  the  domain  is  also  not  supplied,  all  temporary  passwords  for  all  login  levels  are  removed  from 
every  switch  in  the  fabric. 

Each  switch  has  four  accounts:  root,  factory,  admin,  and  user.  Root  and  factory  accounts  are  disabled  for 
non-FCS  switches.  If  they  are  temporarily  activated  by  secTempPasswdSet,  those  accounts  are  disabled 
by  secTempPasswdReset  or  rebooting  the  switch. 


NOTE:    This  command  can  be  issued  only  from  secure  mode  and  only  from  the  primary  PCS  switch. 


command. 


Operands 


This  command  has  the  following  operands: 


login_name 


domain 


Specify  the  domain  of  the  switch  from  which  the  temporary  passwords 
are  to  be  removed.  This  operand  is  optional. 

Specify  the  name  of  the  login  account  from  which  the  temporary 
password  are  removed.  This  operand  is  optional. 


Fabric  OS  5.0.0  command  reference  guide  579 


Examples 

To  remove  temporary  passwords: 


switch: admin>  sectemppasswdreset  2,  "root" 

Account  root  has  been  successfully  disabled  on  domain  2 


switch: admin>  sectemppasswdreset  2 

Restoring  password  of  every  account  on  domain  2 

Temporary  password  of  each  account  on  domain  2  has  been  successfully 
reset   (if  switch  is  non  fcs  switch  it  will  further  display) . 

Root  and  factory  accounts  on  domain  2  have  been  disabled. 


switch: admin>  sectemppasswdreset 

All  temporary  passwords  or  account  settings  have  been  restored  to 
fabric-wide  secure  settings. 

Passwords  of  permanent  accounts  have  been  reset  to  fabric-wide 
values .   Root  and  factory  accounts  on  each  Non  FCS  switch  have 
been  disabled. 

See  also 

secModeDi sable 
secModeShow 
secNonFcsPasswd 
secTempPasswdSet 
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secTem  pPasswdSet 


Sets  a  temporary  password  on  a  remote  switch. 

Synopsis 

sectemppasswdset  domain,  login_naine 

Availability 

admin 

Description 

Use  this  command  to  set  a  unique  temporary  password  for  a  given  account  on  a  specific  switch  in  the 
fabric.  Use  the  secTempPasswdReset  command  to  remove  the  temporary  password  or  reboot  the 
switch. 

You  can  change  any  password  on  any  switch.  To  change  the  password  of  an  account  that  has  higher  level 
than  that  of  the  current  user  logged  in  to  the  primary  FCS  switch,  you  must  enter  the  password  of  the  same 
level  account  on  the  primary  FCS  switch. 

The  password  setup  on  the  target  is  not  persistent  and  will  be  reset  to  the  secure  fabric-wide  setting  when 
this  target  switch  is  rebooted  or  when  secTempPasswdReset  is  run  on  primary  FCS  switch. 

Each  switch  has  four  accounts:  root,  factory,  admin,  and  user.  Root  and  factory  accounts  are  disabled  for 
non-FCS  switches.  This  command  can  enable  the  root  or  factory  account  on  a  non-FCS  switch  when  you 
specify  a  password  for  those  accounts. 

The  password  should  between  8  and  40  characters. 


NOTE:   This  command  can  be  issued  only  from  secure  mode  and  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  operands: 

domain  Specify  the  domain  of  the  switch  from  which  the  temporary  passwords 

are  to  be  removed.  This  operand  is  optional. 

login_name      Specify  the  name  of  the  login  account  from  which  the  temporary 
password  are  removed.  This  operand  is  optional. 

Examples 

To  set  the  password  on  a  remote  switch  with  a  Domain  of  2: 

switch :adinin>  sectemppasswdset  2,  "root" 

Please  provide  password  of  root  on  primary  FCS  switch 

in  order  to  change  this  password:  ******** 

Set  remote  switch  root  password:  ******** 

Re-enter  new  password:  ******** 

Account  root  has  been  successfully  enabled  on  domain  2 
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See  also 

passwd 

secModeDi sable 
secModeShow 
secNonFcs Passwd 
secTempPasswdReset 
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secTrans  Abort 


Aborts  current  security  transaction. 

Synopsis 

sectransabort 

Availability 

admin 

Description 

Use  this  command  to  abort  the  current  transaction.  This  command  is  used  to  recover  from  management 
application  problems.  This  command  aborts  all  current  changes  that  have  not  been  committed  or 
activated. 


'22^  NOTE:   This  command  can  be  issued  from  any  sv/itch  in  secure  mode. 


Operands 

none 

Examples 

To  abort  the  current  security  transaction: 

switch  :adinin>  sectransabort 
Transaction  has  been  aborted. 

See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secPolicySave 

secStatsShow 


Fabric  OS  5.0.0  command  reference  guide  583 


secVersionReset 


Resets  the  version  stamp  to  0. 

Synopsis 

secversionreset 

Availability 

admin 

Description 

Use  this  command  to  reset  the  version  stamp  of  all  sv/itches  in  a  fabric  to  0,  so  that  it  can  be  joined  to 
another  secure  fabric. 

When  merging  two  or  more  secure  fabrics: 

1.  Determine  which  secure  fabric  will  become  the  FCS_POLICY  controller  fabric:  the  dominant  fabric  to 
which  all  other  secure  fabrics  will  be  merged. 

2.  Use  the  secPolicyAdd,  secPolicyRemove,  and  secPolicyActivate  commands  to  modify  the 
FCS_POLICY  of  the  merging  fabrics  to  match  the  FCS_POLICY  of  the  controller  fabric.  All  secure  fabrics 
to  be  merged  must  have  identical  FCS_POLICY  lists.  The  FCS  policies  of  merged  fabrics  must  match 
exactly;  they  must  contain  the  same  FCS  members  and  in  the  same  order,  or  the  merge  will  fail. 

3.  Reset  the  version  stamp  using  the  secVersionReset  command  on  each  secure  fabric  to  be  merged 
into  the  controller  fabric.  The  controller  fabric  does  not  require  a  version  reset. 

4.  Cascade  the  fabrics  together.  When  the  secure  fabrics  merge,  the  primary  FCS  switch  in  the  controller 
fabric  propagates  its  security  policies  across  the  newly  formed  fabric. 


NOTE:  This  command  must  be  issued  from  a  sectelnet  or  SSH  session  and  can  be  issued  only  from  the 
primary  FCS  switch,  a  non-FCS  when  there  is  no  FCS  switch  in  the  fabric,  or  from  a  disabled  switch. 


Operands 

none 

Examples 

To  reset  the  version  stamp  to  0: 


See  also 


switch: admin>  secversionreset 

About  to  reset  version  stamp  to  0 

Are  you  sure   (yes,   y,   no,   n) : [no] 

Y 

Committing  configuration...  done. 

Security  Policy  Version  Stamp  has 

been  set  to  0 . 

secFabricShow 

secModeDi sable 

secModeShow 

secTrans Abort 
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sensorShow 

Displays  sensor  readings. 

Synopsis 

sensorshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  temperature,  fan,  and  power  supply  status  and  readings  from 
sensors  located  on  the  switch.  The  actual  location  of  the  sensors  varies,  depending  on  the  switch  type. 

Operands 

none 

Examples 

To  view  the  sensor  values: 


switch 

adinin>  sensorshow 

sensor 

1 : 

(Temperature) 

is 

Ok, 

value 

is 

39  C 

sensor 

2  : 

(Temperature) 

is 

Absent 

sensor 

3  : 

(Temperature) 

is 

Absent 

sensor 

4  : 

(Temperature) 

is 

Absent 

sensor 

5  : 

(Temperature) 

is 

Ok, 

value 

is 

26  C 

sensor 

6  : 

( Temperature ) 

is 

Ok, 

value 

is 

27  C 

sensor 

7  : 

(Fan  ) 

is 

Ok, 

speed 

is 

2537 

RPM 

sensor 

8  : 

(Fan  ) 

is 

Ok, 

speed 

is 

2537 

RPM 

sensor 

9  : 

(Fan  ) 

is 

Ok, 

speed 

is 

2556 

RPM 

sensor 

10  : 

(Power  Supply 

) 

is  Ok 

sensor 

11 : 

(Power  Supply 

) 

is  Absent 

sensor 

12  : 

(Power  Supply 

) 

is  Ok 

sensor 

13  : 

(Power  Supply 

) 

is  Absent 

See  also 

f anShow 
tempShow 
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setDbg 

Sets  debug  level  of  the  specified  module. 

Synopsis 

setdbg   [inodule_naine]  [level] 

Availability 

admin 

Description 

Use  this  command  to  set  the  debug  level  of  a  specified  module. 


\^^}f  NOTE:  High  debug  level  values  can  generate  a  large  volume  of  messages,  degrading  the  system 
C— I    response  time. 


Operands 

This  command  has  the  follov/ing  operands: 

module_name        Specify  the  name  of  the  module  for  which  you  want  to  view  the  debug  and 
verbosity  levels.  Module  names  are  case  sensitive.  This  operand  is  optional; 
if  omitted,  this  command  displays  the  debug  and  verbose  level  for  all 
modules. 

level  Specify  the  debug  level  for  the  specified  module  (0  to  9).  A  0  value 

(default)  specifies  that  no  messages  are  to  display.  Higher  values  cause 
more  messages  from  that  module  to  display.  This  operand  is  optional,  if 
omitted,  this  command  displays  the  current  debug  and  verbose  level  of  the 
specified  module. 

Examples 

To  set  debug  level  of  module  named  NS  to  value  3: 


switch 

admin> 

setdbg  NS  3 

switch 

admin> 

dbgshow  NS 

Module 

NS, 

debug  level  =  3 ,  verbose  level  =  0 

See  also 

dbgShow 
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setEsdMode 

Enables  or  disables  ESD  mode. 

Synopsis 

setesdmode   [mode   \  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  ESD  mode.  The  mode  is  saved  in  flash  memory  and  stays  in  that 
mode  until  the  next  execution  of  setEsdMode.  The  mode  becomes  active  as  soon  as  this  command  is 
executed.  It  does  not  require  a  reboot  to  take  effect. 

ESD  mode  modifies  the  behavior  of  the  diagnostic  test  methods  and  post  scripts.   The  exact  behavior 
varies  but  most  commonly  consists  of  disabling  the  ports  defined  vvith  diagEsdPorts  when  spinSilk 
or  other  functional  tests  are  run  for  ESD  or  EMI  testing  purposes. 

Operands 

This  command  has  the  following  operands: 

mode  Specify  1  to  enable  ESD  mode,  0  to  disable  ESD  mode.  This 

operand  is  optional. 

-show  Specify  this  operand  to  display  the  current  mode  setting.  This 

operand  is  optional. 

If  no  operand  is  specified,  the  current  value  displays. 

Examples 

To  display  the  ESD  mode: 

switch : adinin>  setesdmode  -show 
Esd  Mode  is  0   (Disabled) . 

See  also 

diagEsdPorts 
spinSilk 
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setGbicMode 


Enables  or  disables  media  mode. 

Synopsis 

setmediamode   [mode   |  -show] 
setgbicmode   [mode   |  -show] 
setsfpmode   [mode   |  -show] 

Availability 

admin 

Description 

Use  these  commands  to  enable  media  mode  (GBIC  or  SFP)  if  the  mode  value  is  nonzero  and  disable  the 
media  mode  if  the  mode  value  is  0.  The  mode  is  saved  in  flash  memory  and  stays  in  that  mode  until  the 
next  execution  of  setMediaMode,  setSfpMode,  or  setGbicMode.  The  mode  becomes  active  as  soon 
as  this  command  is  executed.  It  does  not  require  a  reboot  to  take  effect. 

Media  mode  modifies  the  behavior  of  the  diagnostic  test  methods  so  that  ports  without  media  installed  are 
not  tested.  Normally,  tests  such  as  crossPortTest  or  spinSilk  fail  if  any  port  is  not  operating 
properly,  but  with  media  mode  enabled,  the  functional  tests  are  skipped  on  ports  that  do  not  contain 
media. 

Operands 

This  command  has  the  following  operands: 

mode  Specify  1  to  enable  ESD  mode,  0  to  disable  BSD  mode.  This  operand  is 

optional. 

-show  Specify  this  operand  to  display  the  current  mode  setting.  This  operand  is 

optional. 

Examples 

To  enable,  disable,  and  then  display  the  media  mode: 

switch : admin>  setgbicmode  1 
GBIC  mode  is  now  1    (Enabled) . 
switch: admin>  setsfpmode  0 
SFP  mode  is  now  0   (disabled) . 
switch : admin>  setmediamode  -show 
Media  mode  is  now  0   (disabled) . 

See  also 

crossPortTest 

itemList 

miniCycle 

spinJitter 

spinSilk 
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setMediaMode 


Enables  or  disables  media  mode. 

Synopsis 

setmediamode   [mode   \  -show] 
setgbicmode   [mode   \  -show] 
setsfpmode   [mode   \  -show] 

Availability 

admin 

Description 

Use  these  commands  to  enable  media  mode  (GBIC  or  SFP)  if  the  mode  value  is  nonzero  and  disable  the 
media  mode  if  the  mode  value  is  0.  The  mode  is  saved  in  flash  memory  and  stays  in  that  mode  until  the 
next  execution  of  setMediaMode,  setSfpMode,  or  setGbicMode.  The  mode  becomes  active  as  soon 
as  this  command  is  executed.  It  does  not  require  a  reboot  to  take  effect. 

Media  mode  modifies  the  behavior  of  the  diagnostic  test  methods  so  that  ports  v/ithout  media  installed  are 
not  tested.  Normally,  tests  such  as  crossPortTest  or  spinSilk  fail  if  any  port  is  not  operating 
properly,  but  with  media  mode  enabled,  the  functional  tests  are  skipped  on  ports  that  do  not  contain 
media. 

Operands 

This  command  has  the  follov/ing  operands: 

mode  Specify  1  to  enable  ESD  mode,  0  to  disable  BSD  mode.  This  operand  is  optional. 

-show  Specify  this  operand  to  display  the  current  mode  setting.  This  operand  is  optional. 

Examples 

To  enable,  disable,  and  then  display  the  media  mode: 

switch :  adinin>  setgbicmode  1 
GBIC  mode  is  now  1    (Enabled) . 
switch :admin>  setsfpmode  0 
SFP  mode  is  now  0   (disabled) . 
switch : ad[nin>  setmediamode  -show 
Media  mode  is  now  0   (disabled) . 


See  also 


crossPortTest 

itemList 

miniCycle 

spinJitter 

spinSilk 
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setMfgMode 

Sets  or  displays  diagnostic  MFG  mode. 

Synopsis 

setmfgmode   [  mode   |    -show  ] 

Availability 

admin 

Description 

This  command  enables  MFG  mode  if  mode  is  nonzero  and  disables  the  MFG  mode  if  mode  is  0.  The 
mode  is  saved  in  flash  memory  and  stays  in  that  mode  until  the  next  execution  of  setMfgMode.  The  mode 
becomes  active  as  soon  as  this  command  is  executed;  it  does  not  require  a  reboot  to  take  effect. 

When  enabled,  MFG  mode  modifies  the  behavior  of  the  diagnostic  test  methods  and  pov/er-on  self-test 
(POST)  scripts.  The  exact  behavior  of  this  mode  varies  but  most  commonly  consists  of  enabling  extra 
manufacturing-specific  tests  and  data  patterns. 

Options 

The  following  are  optional: 

mode  Specifies  the  MFG  mode  value.  0  disables  MFG  mode;  any  other  value 

enables  MFG  mode. 

-show  If  specified,  or  if  no  mode  is  given,  the  current  MFG  mode  displays. 

Examples 

To  display  the  current  MFG  mode: 

switch : admin>  setmfgmode  -show 
Mfg  Mode  is  0  (Disabled) 

See  also 

none 


590   Fabric  OS  commands 


setModem 

Enables  or  disables  modem  dial-in  to  a  control  processor  (CP). 

Synopsis 

setmodem   [-e]    |  [-d] 

Availability 

admin 


Description 

Use  this  command  to  enable  or  disable  modem  dial-in  to  a  CP  on  those  systems  that  support  modem 
dial-in.  When  modem  dial-in  is  enabled,  the  user  can  log  in  to  a  CP  through  a  modem,  and  a  modem 
attached  to  the  CP  accepts  the  call.  When  modem  dial-in  is  disabled,  the  modem  attached  to  the  CP  does 
not  accept  the  call.  When  entered  with  no  operands,  the  command  displays  the  currently  state  of  modem 
dial-in. 

Modem  dial-in  must  be  through  a  Hayes-compatible  modem  attached  to  a  CP  modem  serial  port.  In  the 
recommended  configuration,  a  separate  modem  is  connected  to  each  modem  port  of  CPO  and  CPl . 
These  modems  connect  to  the  telephone  outlet  through  a  RJ-1 1  Y-adapter  and  standard  telephone  wire. 

When  both  CP  cards  are  connected  to  a  shared  telephone  line,  callers  are  automatically  dialed  in  to  the 
active  CP  card,  which  answers  on  the  first  ring  unless  modem  dial-in  has  been  disabled.  If  the  active  CP 
card  cannot  answer  for  any  reason,  the  standby  CP  card  answers  on  the  seventh  ring  and  allows  the  login 
to  proceed,  unless  modem  dial-in  has  been  disabled. 

Refer  to  the  hardware  reference  manual  for  your  platform  for  complete  modem  installation  instructions. 

Operands 

The  optional  operands  are  as  follows: 

-e  Specifies  that  modem  dial-in  be  enabled, 

-d  Specifies  that  modem  dial-in  be  disabled. 

Examples 

To  disable  modem  dial-in  to  a  CP: 

switch :  adinin>  setmodem  -d 

disabling  modem,   please  wait,    this  can  take  a  couple  of  minutes... 
modem  disabled 


See  also 

none 
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setSfpMode 

Enables  or  disables  media  mode. 

Synopsis 

setmediamode   [mode   \  -show] 
setgbicmode   [mode   \  -show] 
setsfpmode   [mode   \  -show] 

Availability 

admin 

Description 

Use  these  commands  to  enable  media  mode  (GBIC  or  SFP)  if  the  mode  value  is  nonzero  and  disable  the 
media  mode  if  the  mode  value  is  0.  The  mode  is  saved  in  flash  memory  and  stays  in  that  mode  until  the 
next  execution  of  setMediaMode,  setSfpMode,  or  setGbicMode.  The  mode  becomes  active  as  soon 
as  this  command  is  executed.  It  does  not  require  a  reboot  to  take  effect. 

Media  mode  modifies  the  behavior  of  the  diagnostic  test  methods  so  that  ports  without  media  installed  are 
not  tested.  Normally,  tests  such  as  crossPortTest  or  spinSilk  fail  if  any  port  is  not  operating 
properly,  but  with  media  mode  enabled,  the  functional  tests  are  skipped  on  ports  that  do  not  contain 
media. 

Operands 

This  command  has  the  following  operands: 

mode  Specify  1  to  enable  media  mode  or  0  to  disable  media  mode.  If  no 

mode  is  specified,  the  current  value  is  displayed.  Any  other  value  will 
enable  media  mode. 

■show  Specify  the  -show  operand  to  display  the  current  setting.  This  operand  is 

optional. 

Examples 

To  enable,  disable,  and  then  display  the  media  mode: 

switch : admin>  setgbicmode  1 
GBIC  mode  is  now  1    (Enabled) . 
switch: admin>  setsfpmode  0 
SFP  mode  is  now  0   (disabled) . 
switch : admin>  setmediamode  -show 
Media  mode  is  now  0   (disabled) . 

See  also 

crossPortTest 

itemList 

miniCycle 

spinJitter 

spinSilk 
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setSplbMode 

Sets  or  displays  SPLB  mode. 

Synopsis 

setsplbmode   [mode   \  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  MFG  mode  if  mode  is  a  nonzero,  and  disable  SPLB  mode  if  mode  is  0.  The 
mode  is  saved  in  flash  memory  and  stays  in  that  mode  until  the  next  execution  of  setSplbMode.  The 
mode  becomes  active  as  soon  as  this  command  is  executed.  It  does  not  require  a  reboot  to  take  effect. 

The  SPLB  mode,  when  enabled,  forces  the  spinSilk  command  to  disable  two-port  loopback  for 
M->M  connected  ports.  This  might  be  useful  to  isolate  internal  switch  problems  from  SFP  problems  since 
the  internal  paths  are  used  much  less  with  SPLB  mode  enabled. 

Disabling  SPLB  mode,  forces  the  spinSilk  command  to  circulate  frames  between  pairs  of  M->M 
connected  ports  as  follows: 

PI   TX  >»   PI   RX   ->   P2   TX  »>   P2   RX   ->   PI  TX 

»>  is  a  cable  or  internal  loopback  . 
■>  is  a  routing  table  entry. 

The  connections  between  pairs  of  M->M  ports  are  chosen  to  exercise  the  connections  between  as  many 
chips  (or  bloom  quadrants)  as  possible,  subject  to  the  setting  of  allow_intra_chip  and  the  availability  of 
pairs  of  M->M  ports. 

Any  ports  that  are  cross-cabled  are  routed  to  each  other  in  the  normal  manner,  regardless  of  the  setting  of 
SPLB  mode: 

PI  TX  >»  P2  RX  ->  PI  TX 
P2   TX  >»   PI   RX   ->   P2  TX 

Operands 

This  command  has  the  following  operands:  : 

mode  Specify  1  to  enable  media  mode  or  0  to  disable  media  mode.  If  no 

mode  is  specified,  the  current  value  is  displayed.  Any  other  value  will 
enable  media  mode. 

■show  Specify  the  -show  operand  to  display  the  current  setting.  This  operand  is 

optional. 

Examples 

To  enable  or  disable  a  two-port  loopback: 

switch :ad[nin>  setsplbmode  -show 
Splb  Mode  is  0  (Disabled) 

See  also 

spinSilk 
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setVerbose 

Specifies  module  verbose  level. 

Synopsis 

setverbose   [module_naine]  [level] 

Availability 

admin 

Description 

Use  this  command  to  set  the  verbose  level  of  the  specified  module.  These  levels  filter  the  display  of  the 
debug  message  to  the  serial  console.  By  default,  no  debug  messages  are  displayed. 

Operands 

This  command  has  the  follov/ing  operands: 

module_name  Specify  the  name  of  the  module  for  which  verbose  level  is  to  be 

set;  module  names  are  case  sensitive. 

-level  Specify  the  verbose  level  (0  to  9). 

Examples 

To  set  the  verbose  level  of  module  named  NS  to  value  3: 

switch: admin>  setverbose  NS  3 
switch: admin>  dbgshow  NS 

Module  NS,  debug  level  =  0,  verbose  level  =  3 

See  also 

dbgShow 
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sfpShow 


Displays  serial  ID  SFP  information. 


Synopsis 

sfpshow   [slotnumber/ ]  [portnumber]    \  [-all] 

Availability 

all  users 

Description 

Use  this  command  to  display  information  about  serial  identification  SFPs  (also  known  as  module  definition 
4  SFPs).  These  SFPs  provide  extended  information  that  describes  the  SFPs  capabilities,  interfaces, 
manufacturer,  and  other  information. 


NOTE:    SFPs  are  polled  by  a  background  process.  The  sfpShow  command  retrieves  the  latest  information 
li— I    from  cache.  The  cache  values  for  each  SFP  are  updated  v/hen  the  SFP  is  hot  plugged,  v/hen  it  is  removed, 
or  when  the  Fabric  OS  polls  the  SFPs.  In  the  Core  Switch  2/64  and  SAN  Director  2/1  28,  if  there  is  a  lot 
of  activity  on  the  switch,  poll  updates  might  take  several  minutes. 


Use  this  command  with  no  operand  to  display  a  summary  of  all  SFPs  in  the  switch.  The  summary  displays 
the  SFP  type  (refer  to  switchShow  for  an  explanation  of  the  two-letter  codes)  and,  for  serial  ID  SFP,  the 
vendor  name  and  SFP  serial  number. 

Use  this  command  with  the  slotnumber  and  portnumber  operands  to  display  detailed  information 
about  the  serial  ID  SFP  in  that  port.  Use  the  -all  operand  to  display  detailed  information  for  all 
available  SFPs. 

For  Finisar  smart  SFPs,  five  additional  fields  display:  module  temperature,  voltage,  received  optical  power, 
transmitted  optical  power  (longwave  only),  and  laser  diode  drive  current. 

Operands 

This  command  has  the  following  operands: 


portnumber 


-all 


slotnumber 


Specify  the  slot  number  for  a  Core  Switch  2/64  or  SAN  Director 
2/128.  For  all  other  switches,  this  operand  is  not  required.  The  slot 
number  must  be  followed  by  a  slash  (  /  )  and  the  port  number,  so  that 
each  port  is  represented  by  both  slot  number  (1  through  4  or  7  through 
10)  and  port  number  (0  through  15).  The  Core  Switch  2/64  and  SAN 
Director  2/1 28  have  a  total  of  1 0  slots.  Slot  numbers  5  and  6  are 
control  processor  cards;  slots  1  through  4  and  7  through  1 0  are  port 
cards.  On  each  port  card,  there  are  1 6  ports,  counted  from  the  bottom, 
numbered  0  to  15. 

Specify  a  port  number.  Valid  values  for  port  number  vary,  depending  on 
the  switch  type.  This  operand  is  optional. 

Displays  detailed  data  for  all  available  SFPs  on  the  switch.  This  operand 
is  not  compatible  with  slotnumber /portnumber. 
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Examples 


To  display  SFP  summary  information: 

switch :user>  sfpshow 


Area 

0: 

id 

(id) 

Vendor : 

Serial 

No: 

Area 

1  : 

id 

(sw) 

Vendor : 

FINISAR 

CORP. 

Serial 

No: 

H1149T2 

Area 

2  : 

id 

(sw) 

Vendor : 

FINISAR 

CORP. 

Serial 

No: 

H112TUD 

Area 

3  : 

id 

(sw) 

Vendor : 

FINISAR 

CORP. 

Serial 

No: 

H11QET9 

Area 

4  : 

id 

(sw) 

Vendor : 

IBM 

Serial 

No: 

21P53380BROBE 

Area 

5: 

id 

(sw) 

Vendor : 

IBM 

Serial 

No: 

21P53380BS18A 

Area 

6: 

id 

(sw) 

Vendor : 

IBM 

Serial 

No: 

21P53380BS170 

Area 

7  : 

id 

(sw) 

Vendor : 

IBM 

Serial 

No  : 

21P53380BS26B 

Area 
Area 
Area  10 
Area  11 
Area  12 
Area  13 
Area  14 
Area  15 
Area  16 
( output 


9: 


id  (sw)  Vendor: 
truncated) 


AGILENT 


Serial  No:  0105091301045274 
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To  display  detailed  SFP  information  for  a  Finisar  smart  SFP: 


switch:user> 

sfpshow  1/3 

Identifier : 

3 

SFP 

Connector : 

7 

LC 

Transceiver : 

050c4 

0200000000 

0  100,200_MB/s  M5 , M6  sw  Inter_dist 

Encoding : 

1 

8B10B 

Baud  Rate : 

21 

(units  100 

megabaud) 

Length  9u: 

0 

(units  100 

meters ) 

Length  50u: 

30 

(units  10 

meters ) 

Length  62 . 5u : 

:  15 

(units  10 

meters ) 

Length  Cu: 

0 

(units  1  meter) 

Vendor  Name : 

FINISAR  CORP. 

Vendor  QUI : 

00:90 

:  65 

Vendor  PN: 

FTRJ- 

8519-7D-2 . 

5 

Vendor  Rev : 

Options : 

0012 

Loss_of_Si 

g , Tx_Di sable 

BR  Max: 

0 

BR  Min: 

0 

Serial  No: 

H11QET9 

Date  Code: 

02042 

9 

Temperature : 

50  Centigrade 

Current : 

10634 

mAmps 

Voltage : 

3164  . 

8  mVolts 

RX  Power: 

199  .  6 

uWatts 

TX  Power: 

235.2 

uWatts 
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To  display  all  SPF  information: 


switch :user> 

sfpshow  -all 

Port     0 : 

Identifier : 

3  SFP 

Connector : 

7  LC 

Transceiver : 

050c402000000000  100,200_MB/s  M5,M6  sw  Inter_dist 

Encoding : 

1  8B10B 

Baud  Rate: 

21       (units  100  megabaud) 

Length  9u: 

0         (units  km) 

Length  9u: 

0         (units  100  meters) 

Length  50u: 

30       (units  10  meters) 

Length  62 . 5u : 

:15       (units  10  meters) 

Length  Cu : 

0         (units  1  meter) 

Vendor  Name : 

IBM 

Vendor  OUI : 

08:00:5a 

Vendor  PN: 

IBM42P21SNY 

Vendor  Rev: 

AAIO 

Wavelength : 

0         (units  nm) 

Options : 

001a  Loss_of_Sig, Tx_Fault , Tx_Disable 

BR  Max: 

5 

BR  Min: 

5 

Serial  No: 

21P7053164529 

Date  Code: 

01060501 

(output  truncated) 

See  also 

switchShow 
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shellFlowControlDisable 

Disables  XON/XOFF  flow  control  on  the  console  serial  ports. 

Synopsis 

shellf lowcontroldisable 

Availability 

admin 

Description 

Use  this  command  to  disable  XON/XOFF  flow  control  on  the  console  serial  ports.  Flow  control  is  disabled 
by  default. 

Because  this  command  changes  the  flow  control  on  the  console  serial  port,  it  must  be  executed  from  a 
session  that  is  logged  in  from  the  console  serial  port.  This  command  cannot  run  from  a  telnet  session. 

This  setting  saves  in  the  configuration  database;  therefore,  persistent  across  reboots  and  power  cycles. 

On  dual  control  processor  (CP)  systems,  a  reboot  on  the  standby  CP  is  required  for  this  command  to  take 
effect.  No  action  is  required  on  the  active  CP. 

Operands 

none 

Examples 

To  disable  flow  control: 

switch : admin>  shellf lowcontroldisable 

Disabling  flowcontrol 

flow  control  is  now  disabled 

See  also 

shellFlowControlEnable 
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shellFlowControlEnable 

Disables  XON/XOFF  flow  control  to  the  shell  task. 

Synopsis 

shellflowcontrol enable 

Availability 

admin 

Description 

Use  this  command  to  enable  XON/XOFF  flow  control  to  the  shell  task.  Flow  control  is  disabled  by  default. 

Because  this  command  changes  the  flow  control  on  the  console  serial  port,  it  must  be  executed  from  a 
session  that  is  logged  in  from  the  console  serial  port.  This  command  cannot  run  from  a  telnet  session. 

This  setting  saves  in  the  configuration  database;  therefore,  persistent  across  reboots  and  power  cycles. 

On  dual  control  processor  (CP)  systems,  a  reboot  on  the  standby  CP  is  required  for  this  command  to  take 
effect.  No  action  is  required  on  the  active  CP. 

A CAUTION:  Clf  flow  control  is  enabled  and  if  the  console  output  is  suspended  for  an  extended  period  of 
time,  the  switch  might  reboot.  It  is  recommended  to  disable  the  flow  control,  using 

she 1 IF lowControlDi sable. 


Operands 

none 

Examples 

To  enable  flow  control: 

switch : admin>  shellf lowcontrolenable 

Enabling  flowcontrol 

flow  control  is  now  enabled 

See  also 

shellFlowControlDi sable 
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sin 

Displays  system  inventory. 

Synopsis 

sin   [   -h  ] 

Availability 

admin 

Description 

sin  with  no  arguments  prints  the  system  hardware  information. 

Operands 

The  operand  is  as  follows: 


Examples 

To  display  the  system  inventory: 

switch : admin>  sin 

Platform:   SWBDIO,   Revision  1 

Processor:  Id  1 

See  also 

none 
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slotOff 

Disables  a  blade  slot. 


Synopsis 

slotoff  slotnumber 

Availability 

admin 

Description 

Use  this  command  to  disable  a  nonfaulty  blade  unit  while  leaving  the  blade  unit  powered  on. 

This  command  disables  both  the  external  and  internal  ports  on  the  blade,  in  contrast  to  the 
bladeDisable  command,  which  only  disables  external  ports.  Unlike  ports  affected  by  bladeDisable, 
ports  on  a  slot  disabled  by  this  command  are  not  re-enabled  after  switchEnable,  switchStart,  or 
switchReboot. 

Operands 

This  command  has  the  following  operand: 

slotnumber  Specify  the  slot  number  of  the  blade  to  disable.  This  operand  is 

required. 

Examples 

To  power  off  blade  unit  3: 

switch :  ac3inin>  slotoff  3 
Slot  3  is  being  disabled. 


See  also 

bladeDisable 

slotOn 

slotShow 
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slotOn 

Enables  a  blade  slot. 

Synopsis 

sloton  slotnumber 

Availability 

admin 

Description 

Use  this  command  to  reenable  a  blade  unit  that  was  previously  disabled. 

Operands 

This  command  has  the  following  operand: 

slotnumber  Specify  the  slot  number  of  the  blade  to  disable.  This  operand  is  required. 

Examples 

To  power  off  blade  unit  3: 

switch : admin>  sloton  3 
Slot  3  is  being  enabled. 

See  also 

slotOf f 
slotShow 
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slotPowerOff 

Removes  power  from  a  slot. 

Synopsis 

slotpoweroff  slotnumber 

Availability 

admin 

Description 

Use  this  command  to  turn  off  the  power  to  a  blade  unit.  The  slot  must  have  a  valid  blade  unit  present  and 
the  blade  unit  must  be  of  a  type  that  can  be  powered  off. 

Operands 

This  command  has  the  following  operand: 

slotnumber       Specify  the  slot  number  of  the  blade  to  disable.  This  operand  is  required. 

Examples 

To  power  off  blade  unit  3: 

switch :  ac3inin>  slotpoweroff  3 
Slot  3  is  being  powered  off 

See  also 

powerOff List Set 
powerOf f ListShow 
slotPowerOn 
slotShow 
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slotPowerOn 

Restores  power  to  a  slot. 

Synopsis 

slotpoweron  slotnumber 

Availability 

admin 

Description 

Use  this  command  to  turn  on  the  power  to  a  blade  unit.  The  slot  must  have  a  valid  blade  unit  present  and 
the  blade  unit  must  be  currently  powered  off.  The  slotShow  command  reports  such  slots  as  being  in  the 
state  of  INSERTED,  NOT  POWERED  ON. 

Operands 

This  command  has  the  following  operand: 

slotnumber  Specify  the  slot  number  of  the  blade  to  disable.  This  operand  is  required. 

Examples 

To  power  on  blade  unit  3: 

switch :  adinin>  slotpoweron  3 
Powering  on  slot  3  . 


See  also 

slotOn 

slotPowerOf f 
slotShow 
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slotShow 


Displays  slot  status. 


Synopsis 


slotshow 


Availability 

all  users 

Description 

Use  this  command  to  inventory  and  display  the  current  status  of  each  slot  in  the  system.  The  fields  and  their 
possible  values  are  as  follov/s: 


Slot 

Blade  Type 


ID 


Status 


Displays  the  physical  slot  number. 
Displays  the  blade  type: 

SW  BLADEThe  blade  is  a  sv^itch. 

CP  BLADE  -  The  blade  is  a  control  processor. 

UNKNOWN  -  Blade  not  present  or  its  type  is  not  recognized 
Displays  the  hardv/are  ID  of  the  blade  type. 

1  represents  a  Core  Switch  2/64  CP  BLADE 

2  represents  a  Core  Switch  2/64  SW  BLADE 

4  represents  a  SAN  Director  2/1  28  SW  BLADE 

5  represents  a  SAN  Director  2/1  28  CP  BLADE 
Displays  the  status  of  the  blade: 

VACANT  -  The  slot  is  empty. 

INSERTED,  NOT  POWERED  ON  -  The  blade  is  present  in  the  slot  but  is  turned 
off. 

DIAG  RUNNING  POSTl  -The  blade  is  present,  powered  on,  and  running  the 
POSTl  (power-on  self-test  1). 

DIAG  RUNNING  POST2  -The  blade  is  present,  powered  on,  and  running  the 
POST2  (power-on  self-test  2). 

ENABLED  -The  blade  is  on  and  enabled. 

DISABLED  -The  blade  is  powered  on  but  disabled. 

FAULTY  -The  blade  is  faulty  because  an  error  was  detected. 

UNKNOWN  -The  blade  is  inserted  but  its  state  cannot  be  determined. 


Operands 


none 
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Examples 


To  display  a 

blade  inventory  and  status: 

switch :  adinin>  slotshow 

Slot 

Blade  Type 

ID 

Status 

1 

SW  BLADE 

2 

FAULTY 

2 

SW  BLADE 

2 

DISABLED 

3 

SW  BLADE 

2 

ENABLED 

4 

SW  BLADE 

2 

DIAG  RUNNING  P0ST2 

c; 
O 

LF  BLADE 

1 

ENABLED 

6 

CP  BLADE 

1 

ENABLED 

7 

UNKNOWN 

VACANT 

8 

SW  BLADE 

2 

DIAG  RUNNING  POSTl 

9 

SW  BLADE 

2 

INSERTED,    NOT   POWERED  ON 

10 

UNKNOWN 

VACANT 

See  also 

bladeDisable 
bladeEnable 
chassisShow 
slotOf f 
slotOn 

slotPowerOf f 
slotPowerOn 
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siTest 


Tests  the  serial  link  of  port  N->N  path. 


Synopsis 


sltest  [  -ports  itemlist  ] [  -lb_mode  mode  ] [  -speed  mode  ] 
[   -passcnt  count  ] [   -duration  count  ] 


Availability 


admin 


Description 


Use  this  command  to  verify  the  intended  functional  operation  of  the  switch  by  sending  SERDES  BIST 
patterns  from  port  N's  transmitter,  and  looping  the  patterns  back  into  the  same  port  N's  receiver.  The 
loopback  is  done  at  the  parallel  and  serial  loopback  paths.  The  path  exercised  in  this  test  can  include  the 
media  or  the  fiber  cable. 

The  test  patterns  are  transmitted  and  received  continuously  during  the  test  duration.  An  external  cable  is 
optional  to  run  this  test. 

The  test  method  is  as  follows: 

1.  Set  all  ports  present  for  one  of  the  following  modes:  parallel,  SERDES  pads,  or  external  cable 
loopback. 

2.  Program  the  port  to  repeatedly  send  predefined  LPE. 

3.  Verify  the  primitive  is  received  at  the  same  port. 

4.  Check  the  receive  port  for  possible  code  violation  on  nonframe  data  or  BadOrdSet. 

5.  Repeat  steps  2  through  4  for  all  ports  present  until: 

a.  The  number  of -passcnt  count  requested  is  reached. 

b.  All  ports  are  marked  bad. 


Operands 


The  optional  operands  are  as  follows: 


-lb_mode  mode 


Sets  the  loopback  point  for  the  test.  By  default,  slTest  uses  internal 
loopback.  Available  modes  are  as  follows: 

1  Port  loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 
5  Internal  (parallel)  loopback 

7  Backend  bypass  and  port  loopback 

8  Backend  bypass  and  SERDES  loopback 

9  Backend  bypass  and  internal  loopback 


■speed  mode 


Specifies  the  speed  mode  for  the  test.  Available  modes  are  as  follows: 

1  Runs  the  test  at  both  1  Gb/s 

2  Sets  and  locks  all  port  speeds  to  2  Gb/s 

3  Sets  and  locks  all  port  speeds  to  3  Gb/s 

4  Sets  and  locks  all  port  speeds  to  4  Gb/s  (default) 
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-ports  itemlist  Specifies  a  list  of  blade  ports  to  test.  By  default  all  the  blade  ports  in  the 

specified  slot  (--slot)  is  used. 


Refer  to  itemList  for  further  details. 

Examples 

To  test  the  serial  link  of  the  following  port  path: 

switch :adinin>  sltest  -ports  0/5-0/31  -speed  4  -lb_inode  1  passcnt  1 

Running  Port  sltest  .... 

passed. 


Diagnostic 

When  it  detects  failures,  the  test  might  report  one  or  more  of  the  following  error  messages: 

DATA 

ERRSTAT 

INIT 

STATS 

TIMEOUT 

See  also 

cmemRetentionTest 
cross For tTest 
itemList 
portRegTest 
spinSilk 
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snmpConfig 

Manages  the  SNMP  agent  configuration. 


Synopsis 

snmpConfig  --show  |  --set  |  --default  snmpvl  |  smnpv3  |  accessControl 
mibCapability   |  systemGroup 

Availability 

admin  (set,  default) 

all  users  (display) 


Description 

Use  this  command  to  manage  the  configuration  of  the  SNMP  agent  in  the  switch.  The  configuration 
includes  SNMPvl  and  SNMPvS  configuration,  access  control  list  (ACL),  MIB  capability,  and  system  group. 
It  supports  set,  reset  to  default,  and  display  operations. 

Issue  this  command  with  incomplete  parameters  and  it  displays  the  command  usage. 


["2^^  NOTE:    All  the  new  values  successfully  configured  by  --set  and  --default  options  take  effect 
b— I  immediately. 

The  new  values  change  if  you  download  different  configuration  data  through  the  conf  igDownload 
command. 

The  SNMP  configuration  is  persistent  across  the  reboots. 

On  the  Core  Switch  2/64,  there  is  one  SNMP  agent  per  logical  switch.  This  command  is  specific  to  the 
logical  switch  to  which  you  log  in. 


SNMPvl  Configuration  Parameters 

There  are  six  communities,  respective  trap  recipients  and  trap  recipient  severity  level  supported  by  the 
agent.  The  first  three  communities  are  for  read-write  (rw)  access  and  the  last  three  are  for  read-only  (ro) 
access. 

Note  that  the  default  value  for  the  trap  recipient  of  each  community  is  0.0.0.0.  The  length  of  community 
string  should  be  in  range  of  2  to  16  characters.  The  default  values  for  the  community  strings  are: 

Community  1 :  Secret  COde 

Community  2:  OrigEquipMfr 

Community  3:  private 

Community  4:  public 

Community  5:  common 

Community  6:  FibreChannel 
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NOTE:    When  secure  mode  is  enabled,  community  strings  can  be  changed  on  the  primary  FCS  switch 
only  and  propagates  changes  across  the  fabric. 

For  an  SNMP  management  station  to  receive  a  trap  generated  by  the  agent,  the  administrator  must 
configure  a  trap  recipient  to  correspond  to  the  IP  address  of  the  management  station.  In  addition,  the  trap 
recipient  must  be  able  to  pass  the  access  control  list  (ACL)  check  as  described  in  accessControl  category. 


Trap  recipient  severity  level 

The  event  trap  level  in  conjunction  with  the  an  event's  severity  level.  When  an  event  occurs  and  if  its 
severity  level  is  at  or  below  the  set  value,  the  SNMP  traps.  Event  Trap  traps  (swEventTrap, 
connUnitEventTrap  and  swFabricWatchTrap),  are  sent  to  configured  trap  recipients.  By  default,  this  value  is 
set  at  0,  implying  that  no  Event  Trap  is  sent.  Possible  values  are: 


0 

None 

1 

Critical 

2 

Error 

3 

Warning 

4 

Informationa 

5 

Debug 

SNMPvS  Configuration  Parameters 

Two  user  roles,  snmpadmin  and  snmpuser  are  supported,  snmpadmin  provides  read-write  access  and 
snmpuser  provides  read-only  access.  Entries  are  added  to  USM  table  corresponding  to  each  role.  Total  of 
three  entries  of  role  snmpadmin  and  three  entries  of  role  snmpuser  are  supported.  Separate  default 
passwords  are  provided  for  creation  of  authKey  and  privKey  for  each  entry.  Default  set  of  passwords  are 
published  and  default  algorithm  (MD5/SHA)  is  used  to  create  initial  set  of  auth  keys.  You  can  change 
these  passwords  using  this  option.  You  have  the  option  to  select  authentication  protocol  MD5/SHA  or  no 
authentication  for  each  entry. 

Select  the  following  combination  of  protocols: 

NoAuth/NoPriv 

Auth/NoPriv 

Auth/Priv 

The  length  of  user  name  string  should  be  in  range  of  2  to  32  characters.  Note  that  the  default  user  names 
are  defined  with  noAuth  and  noPriv  protocol.  The  factory  default  SNMPv3  user  names  are: 

User  1 :  snmpadminl 

User  2:  snmpadmin2 

User  3:  snmpadmin3 

User  4:  snmpuserl 

User  5:  snmpuser2 

User  6:  snmpuser3 

The  user  configuration  is  available  in  both  secure  and  nonsecure  mode.  When  user  select  the  --default 
option,  the  user  name  and  passwords  are  set  to  default. 

In  secure  mode,  the  above  configuration  has  to  be  updated  by  user  on  both  primary  and  nonprimary 
switches  individually  and  unlike  community  strings,  user  name  and  passwords  is  not  distributed  for  other 
switches  in  the  fabric. 
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when  new  passwords  are  entered  for  any  user  entry,  new  authKey  and  privKey  are  generated.  You  have 
to  update  the  new  passwords  on  the  client  (such  as  a  MIB  browser)  also.  AuthKey  and  privKey  can  also  be 
updated  using  delta  key  mechanism  provided  by  SNMPv3  protocol. 


You  are  prompted  for  password  and  re-confirmation  of  password,  if  any  protocol  is  selected  other  than 
NoAuth/NoPriv.  The  length  of  protocol  passwords  should  be  in  range  of  1  to  20  characters. 

Note  that  in  order  for  an  SNMP  management  station  to  receive  SNMPv3  traps  generated  by  the  agent, 
the  administrator  must  configure  a  trap  recipient  value  to  correspond  to  the  IP  address  of  the  management 
station.  Also,  in  addition  the  trap  recipient  should  be  able  to  pass  the  ACL  check  as  described  in 
accessControl  section.  The  trap  recipient  value  should  be  associated  with  one  of  the  six  users  of  SNMPvS 
and  trap  severity  level.  Note  that  the  factory  default  value  for  the  SNMPvS  trap  recipient  of  each  user  is 


'0.0.0.0'. 

accessControl  Configuration  Parameters 

The  ACL  check  is  as  follows:  there  are  six  ACLs  to  restrict  SNMP  get/set/trap  operations  to  hosts  under  a 
host-subnet-area.  Host-subnet-area  is  defined  by  comparing  nonzero  IP  octets.  For  example,  an  ACL  of 
1 92. 1 68.64.0  enables  access  by  any  hosts  that  start  with  the  specified  octets.  The  connecting  host  is 
enabled  to  set  each  host-subnet-area  to  be  read-write  or  read-only.  The  highest  privilege  matched  out  of  six 
entries  is  given  to  the  access.  The  ACL  check  is  turned  off  when  all  six  entries  contain  0.0.0.0.  The  default 
values  of  all  six  entries  are  0.0.0.0. 

Note:  When  secure  mode  is  enabled,  the  Access  Control  List  feature  is  incorporated  into  the  WSNMP  and 
RSNMP  security  policies. 

mibCapability  Configuration  Parameters 

This  mibCapability  option  a  turns  on  or  off  certain  MIBS  and  TRAPS. 


["2^  NOTE:    The  agtCf  gDef  ault  also  resets  the  SNMP  MIB  and  Trap  Capability  to  default  with  other  SNMP 


If  SNMP  MIB  is  disabled,  then  corresponding  traps  also  are  disabled.  If  any  trap  group  is  disabled,  then 
corresponding  individual  traps  also  are  disabled. 

The  FE  and  SW  MIBs  are  always  accessible.  snmpMibCapSet  does  not  prompt  you  to  turn  these  MIBs  on 
or  off. 


SW-EXTTRAP 


SW-TRAP 


FA-MIB 


HA-MIB 


FA-TRAP 


Specifying  yes  means  the  user  can  access  FA-MIB  variables  with  an  SNMP 
manager.  The  default  value  is  yes. 

Specifying  yes  means  the  user  can  access  Entity-MIB  and  HA-MIB  variables  with  an 
SNMP  manager.  The  default  value  is  yes. 

Specifying  yes  means  the  SNMP  management  application  can  receive  SW-TRAPS 
from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual  SW 
Traps.  The  individual  SW  traps  are  swFCPortScn,  swEventTrap,  swFabricWatchTrap 
and  swTrackChangesTrap. 

Specifying  yes  means  the  SNMP  management  application  can  receive  FA-TRAPS 
from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual  FA 
Traps.  The  individual  FA  Traps  are  connUnitStatusChange,  connUnitEventTrap, 
connUnitSensorStatusChange  and  connUnitPortStatusChange 

Specifying  yes  means  user  can  receive  SSN  in  the  SW  traps.  The  default  value  is 


no. 


HA-TRAP 


Specifying  yes  means  the  SNMP  management  application  can  receive  HA  traps 
from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual  HA 
Traps.  The  individual  HA  Traps  are  fruStatusChanged,  cpStatusChanged,  and 
fruHistoryTrap. 
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systemGroup  Configuration  Parameters 


sysDescr 
sysLocation 

sysContact 
authTraps 


System  description.  The  default  value  is  set  as  Fibre  Channel  Switch. 

Location  of  the  system  (switch).  The  default  value  is  set  as  End  User 
Premise. 

Contact  information  for  this  system  (sv/itch).  The  default  value  is  set  as  Field 
Support.  Refer  to  the  definition  of  sysDescr,  sysLocation  and  sysContact  in 
system  group  of  MIB-N. 

When  enabled,  the  authentication  trap  (authenticationFailure)  is  transmitted  to 
a  configured  trap  recipient  in  the  event  that  the  agent  received  a  protocol 
message  that  is  not  properly  authenticated.  In  the  context  of  SNMPvl  and 
SNMPv2c,  this  means  that  a  request  contains  a  community  string  that  is  not 
knov/n  to  the  agent.  The  default  value  for  this  parameter  is  0  (disabled). 


Options 


This  command  supports  follov/ing  options: 


--show 
--set 

--default 


Displays  the  SNMP  agent  configuration  data  of  specified  category. 

Sets  the  SNMP  agent  configuration  data  of  specified  category.  This  option 
displays  the  current  settings  and  then  prompts  the  user  to  change  the  values  for 
each  parameter. 

Sets  to  the  default  values  the  SNMP  agent  configuration  data  of  specified  item. 
Generally,  these  default  values  may  be  available  in  configuration  data  base.  It 
sets  to  factory  default  values,  if  SNMP  agent  configuration  parameters  are  not 
available  in  configuration  database. 


Operands 


This  command  supports  following  operands: 


snmpvl 
snmpv3 

accessControl 
mibCapability 

systemGroup 


It  selects  SNMPvl  related  configuration  parameters.  SNMPvl  parameters 
include  community  strings,  trap  recipients's  ip  address  and  trap  severity  level 
associated  with  each  trap  recipients's  ip  address. 

It  selects  SNMPvS  related  configuration  parameters.  SNMPv3  parameters 
include  user  name,  authentication  protocol/password,  privacy 
protocol/ password,  SNMPvS  trap  recipients's  ip  address,  associated  user  index 
and  trap  severity  level. 

It  selects  access  control  related  parameters.  accessControl  parameters  include 
Access  host  subnet  area  and  access  permission  (read-write). 

It  selects  configuration  parameters  related  to  SNMP  agent's  MIBs  and  TRAP 
capability  parameters.  mibCapability  parameters  include  mibs  and  traps 
supported  by  SNMP  agent. 

It  selects  configuration  parameters  related  to  system  group.  systemGroup 
parameters  include  sysDescr,  sysLocation,  sysContact  and  authentication  failure 
trap. 
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Examples 

To  change  the  SNMPvl  configuration: 


switch : admin>  : 

snmpconfig  --set 

snmpvl 

SNMP  community 

and  trap  recipient  i 

configuration : 

ComitiunitY  (rw) 

:    [Secret  COde]  admin 

Trap  Recipient 

's  IP  address  in 

dot 

notation : 

[0. 

0.0 

.0] 

10  .32 .225 . 1 

Trap  recipient 

Severity  level 

:  (0 

..5)    [0]  1 

Community  (rw) 

:    [OrigEquipMf r ] 

Trap  Recipient 

's  IP  address  in 

dot 

notation : 

[10 

.32 

.225 

.2] 

Trap  recipient 

Severity  level 

:  (0 

..5)  [1] 

Community  (rw) 

:  [private] 

Trap  Recipient 

's  IP  address  in 

dot 

notation : 

[10 

.32 

.225 

.3] 

Trap  recipient 

Severity  level 

:  (0 

..5)  [2] 

Community  (ro) 

:  [public] 

Trap  Recipient 

's  IP  address  in 

dot 

notation : 

[10 

.32 

.225 

.4] 

Trap  recipient 

Severity  level 

:  (0 

..5)  [3] 

Community  (ro) 

:  [common] 

Trap  Recipient 

's  IP  address  in 

dot 

notation : 

[10 

.32 

.225 

.5] 

Trap  recipient 

Severity  level 

:  (0 

..5)  [4] 

Community  (ro) 

:    [FibreChannel ] 

Trap  Recipient 

's  IP  address  in 

dot 

notation : 

[10 

.32 

.225 

.6] 

Trap  recipient 

Severity  level 

:  (0 

..5)  [5] 

Committing  configuration ...  done . 
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To  change  the  SNMPvS  configuration: 


switch :adinin>  snmpconfig  --set  snmpv3 

SNMPvS  user  configuration: 

User   (rw) :    [snmpadminl]  adminuser 

Auth  Protocol    [MD5 ( 1 ) /SHA { 2 ) /noAuth ( 3 ) ] : 

(1. 

3) 

[3] 

1 

New  Auth  Passwd: 

Verify  Auth  Passwd: 

Priv  Protocol    [DES ( 1 ) /noPriv [2 ] ) :  (1..2) 

[2] 

1 

New  Priv  Passwd: 

Verify  Priv  Passwd: 

User   (rw) :    [ snmpadmin2 ]  shauser 

Auth  Protocol    [MD5 ( 1 ) /SHA { 2 ) /noAuth ( 3 ) ] : 

(1. 

3) 

[3] 

2 

New  Auth  Passwd: 

Verify  Auth  Passwd: 

Priv  Protocol    [DES  ( 1 )  /noPriv  \_Z  \  )  :    ( 1 .  .  2  ) 

[2] 

1 

New  Priv  Passwd: 

Verify  Priv  Passwd: 

User   (rw)  :    [ snmpaditiin3  ]  nosec 

Auth  Protocol    LMDb ( 1 ) / SHA ( 2 ) /noAuth ( 3 ) J  : 

(1. 

3) 

[3] 

Priv  Protocol    [ DES ( 1 ) / noPriv [ 2 ] )  :    (2  .  .2) 

[2] 

User   (ro) :    [ snmpuserl ] 

Auth  Protocol    LMDb ( 1 ) / SHA ( 2 ) /noAuth ( 3 ) J  : 

(3  . 

3) 

[3] 

Priv  Protocol    [ DES ( 1 ) / noPriv [ 2 ] )  :    ( 2  .  .  2 ) 

[2] 

User   (ro) :  [snmpuser2] 

Auth  Protocol    [MD5 (1) /SHA(2) /noAuth(3) ] : 

(3  . 

3) 

[3] 

Priv  Protocol    L DES ( 1 ) /no Priv  L 2  J )  :    ( 2  .  . 2 ) 

[2] 

User   (ro) :  [snmpuser3] 

Auth  Protocol    [MD5 (1) /SHA(2) /noAuth(3) ] : 

(3. 

3) 

[3] 

Priv  Protocol    [DES ( 1) /noPriv [2 ])  :    (2. .2) 

[2] 

SNMPv3  trap  recipient  configuration: 

192 

Trap  Recipient's  IP  address  in  dot  notation: 
168.45.90 

[0 

0  .  0 

0] 

Userlndex:    (1..6)  [1] 

Trap  recipient  Severity  level   :    (0..5)  [0 

]  4 

192 

Trap  Recipient's  IP  address  in  dot  notation: 
168.45.92 

[0 

0  .  0 

0] 

Userlndex:    (1..6)  [2] 

Trap  recipient  Severity  level   :    (0..5)  [0 

]  2 

Trap  Recipient's  IP  address  in  dot  notation: 

[0 

0  .  0 

0] 

Trap  Recipient's  IP  address  in  dot  notation: 

[0 

0  .  0 

0] 

Trap  Recipient's  IP  address  in  dot  notation: 

[0 

0  .  0 

0] 

Trap  Recipient's  IP  address  in  dot  notation: 

[0 

0  .  0 

0] 

Committing  configuration ...  done . 
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To  change  the  accessControl  configuration: 


switch: admin>  snmpconfig  --set  accessControl 

SNMP  access 

list  configuration: 

Access  host 

subnet 

area  in  dot  notation 

[0 

0 

0 

0] 

192 

.168.0 

0 

Read/Write? 

(true. 

t,   false,   f ) :  [true] 

Access  host 

subnet 

area  in  dot  notation 

[0 

0 

0 

0] 

10  . 

32 . 148 

0 

Read/Write? 

{ true , 

t,   false,   f ) :  [true] 

f 

Access  host 

subnet 

area  in  dot  notation 

[0 

0 

0 

0] 

Read/Write? 

(true. 

t,   false,   f ) :  [true] 

Access  host 

subnet 

area  in  dot  notation 

[0 

0 

0 

0] 

10. 

33.0.0 

Read/Write? 

{ true , 

t,   false,   f ) :  [true] 

f 

Access  host 

subnet 

area  in  dot  notation 

[0 

0 

0 

0] 

Read/Write? 

(true. 

t,   false,   f ) :  [true] 

Access  host 

subnet 

area  in  dot  notation 

[0 

0 

0 

0] 

Read/Write? 

{ true , 

t,   false,   f ) :  [true] 

Committing 

configuration. . .done. 

To  display  the  mibCapability  configuration: 


switch : admin>  snmpconfig  --show  mibCapability 


FE- 

-MIB: 

YES 

sw- 

-MIB: 

YES 

FA- 

-MIB: 

YES 

HA- 

-MIB 

:  YES 


SW-TRAP:  YES 

swFCPortScn:  YES 

swEventTrap :  YES 

swFabricWatchTrap :  YES 

swTraclcChangesTrap :  NO 
FA- TRAP:  YES 

connUnitStatusChange :  YES 

connUnitEventTrap :  NO 

connUnitSensorStatusChange :  YES 

connUnitPortStatusChange :  YES 
SW-EXTTRAP:  NO 

HA-TRAP :  YES 

fruStatusChanged:  YES 

cpStatusChanged:  YES 

f ruHistoryTrap :  NO 
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To  change  the  systemGroup  configuration  to  default: 


switch :admin>  snmpconfig  --default  systemGroup 


This  command  will  reset  the  agent ' s  system  group  configuration  back 
to  factory  default 


sysDescr 


Fibre  Channel  Switch 


sysLocation 


End  User  Premise 


sysContact 


Field  Support 


authTraps 


0  (OFF) 


Are  you  sure?    (yes,   y,   no,   n) :    [no]  y 


See  also 


agtCfgDe fault 
agtCfgSet 
agtCf gShow 
snmpMibCapSet 
snmpMibCapShow 

SW_v5_x.mib,  Switch  Management  Information  &  Switch  Enterprise  Specific  Trap 
RFC!  T57,  A  Simple  Network  Management  Protocol  (SNMPvl) 

RFC! 21 3,  Management  information  Base  for  Network  Management  of  TCP/IP-based  internets:  MIB-II 
RFC2574,  User-based  Security  Model  (USM)  for  version  3  of  the  Simple  Network  Management  Protocol 


(SNMPv3) 
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snmpMibCapSet 


Modifies  options  for  configuring  SNMP  MIB  trap  capability. 


Synopsis 


snmpmibcapset 

Availability 

admin 

Description 

This  command  enables  a  user  to  turn  on  or  off  certain  MIBs  and  traps.  Tfiis  command  also  enables  a  user 
to  turn  on  or  off  group  information  and  SSN  in  SW  trap  messages.  It  first  displays  current  settings  and  then 
prompts  the  user  to  change  the  values  for  each  parameter. 

FA-MIB  Specifying  yes  means  the  user  can  access  FA-MIB  variables  v/ith  an  SNMP 

manager.  The  default  value  is  yes. 

HA-MIB  Specifying  yes  means  the  user  can  access  HA-MIB  variables  v/ith  an  SNMP 

manager.  The  default  value  is  yes. 

SW-TRAP  Specifying  yes  means  the  SNMP  management  application  can  receive  SW-TRAPS 

from  the  switch.  The  default  value  is  yes. 

FA-TRAP  Specifying  yes  means  the  SNMP  management  application  can  receive  FA-TRAPS 

from  the  sv/itch.  The  default  value  is  yes. 

SW-EXTTRAP       Specifying  yes  means  the  SNMP  management  application  can  receive 
SW-EXTTRAPS  from  the  sv^itch.  The  default  value  is  yes. 

HA-TRAP  Specifying  yes  means  the  SNMP  management  application  can  receive  HA-TRAPS 

from  the  switch.  The  default  value  is  yes. 


Operands 


none 


Examples 


To  view  or  modify  the  options  for  configuring  SNMP  MIB  traps: 


switch : admin>  snmpmibcapset 

The  SNMP  Mib/Trap  Capability  has  been  set  to 

support 

FE-MIB   SW-MIB  FA-MII 

3     HA-MIB   SW-TRAP  FA-TRAP 

HA-TRAP 

FA-MIB   (yes,  y, 

no , 

n)  : 

[yes] 

HA-MIB   (yes,  y, 

no. 

n)  : 

[yes] 

SW-TRAP   (yes,  y. 

no 

n) 

[yes] 

FA-TRAP   (yes,  y. 

no 

n) 

[yes] 

SW-EXTTRAP  (yes. 

Y, 

no , 

n) :    [no]  y 

HA-TRAP   (yes,  y. 

no 

n) 

[yes] 

See  also 


agtCfgDefault 
agtCfgSet 
agtCf  gSliow 
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snmpMibCapShow 


Displays  options  for  configuring  SNMP  MIB  trap  capability. 


Synopsis 


snmpMibCapShow 


Availability 

all  users 


Description 

Use  this  command  to  display  the  SNMP  MIBs  and  traps  capability  of  the  SNMP  agent  in  the  switch. 


FA-MIB 


HA-MIB 


SW-TRAP 


FA- TRAP 


SW-EXTTRAP 
HA- TRAP 


Specifying  yes  means  the  user  can  access  FA-MIB  variables  with  an  SNMP 
manager.  The  default  value  is  yes. 

Specifying  yes  means  the  user  can  access  HA-MIB  variables  with  an  SNMP 
manager.  The  default  value  is  yes. 

Specifying  yes  means  the  SNMP  management  application  can  receive  SW-TRAPS 
from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual  SW 
Traps.  The  individual  SW  traps  are  swFCPortScn,  swEventTrap,  swFabricWatchTrap 
and  swTrackChangesTrap. 

Specifying  yes  means  the  SNMP  management  application  can  receive  FA-TRAPS 
from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual  FA 
Traps.  The  individual  FA  Traps  are  connUnitStatusChange,  connUnitEventTrap, 
connUnitSensorStatusChange  and  connUnitPortStatusChange. 

Specifying  yes  means  user  can  receive  SSN  in  the  SW  traps.  The  default  value  is  no. 

Specifying  yes  means  the  SNMP  management  application  can  receive  HA  traps 
from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual  HA 
Traps.  The  individual  HA  Traps  are  fruStatusChanged,  cpStatusChanged,  and 
fruHistoryTrap. 


[^^}f  NOTE:     agtCf gDef  ault  also  resets  the  SNMP  MIB  and  trap  capability  to  default  along  with  other 
li— I    SNMP  agent  configuration. 

The  values  can  be  changed,  if  user  download  the  configuration  data  through  conf  igDownload 

command. 

All  the  new  values  successfully  configured  by  snmpMibCapSet  command  takes  effect  immediately. 

If  SNMP  MIB  is  disabled,  then  the  corresponding  traps  are  disabled.  If  any  trap  group  is  disabled  then  the 

corresponding  individual  traps  also  are  disabled. 


Operands 

none 
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Examples 

To  display: 


switch : admin>  snmpmibcapshow 

FA-MIB:  YES 
HA-MIB:  YES 

SW-TRAP:  YES 

swFCPortScn:  YES 
swEventTrap :  NO 
swFabricWatchTrap :  YES 
swTrackChangesTrap :  YES 

FA-TRAP :  NO 

SW-EXTTRAP:  NO 

HA-TRAP:  YES 

fruStatusChanged:  YES 
cpStatusChanged:  YES 
f ruHistoryTrap :  NO 

See  also 

agtCfgDefault 
agtCfgSet 
agtCf gShow 
snmpConf ig 
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spinFab 

Runs  functional  test  of  switch-to-switch  ISL  cabling  and  trunk  group  operation. 

Synopsis 

spinfab   [-nmegs  count] [-ports  itemlist]  [-setfail  mode]  [-domain  value] 


Availability 

admin 

Description 

Use  this  command  to  verify  the  intended  functional  operation  of  the  ISL  links  between  switches.  At  the 
maximum  speed  of  2  Gb/s,  set  the  routing  hardware  such  that  test  frames  received  by  each  E  Port 
retransmit  on  the  same  E_Port.  Next,  send  several  frames  to  the  neighbor  port  attached  to  each  active 
E_Port  specified.  The  default  action  for  such  frames  is  to  route  them  back  to  the  sender,  which  never  occurs 
for  normal  traffic.  The  frames  circulate  until  the  test  stops  them. 

The  frames  are  continuously  transmitted  and  received  in  all  ports  in  parallel.  The  port  LEDs  flicker  green 
rapidly  while  the  test  is  running.  While  the  frames  are  circulating,  the  RX  frame  count  and  port  CRC  and 
encoder  error  statistics  are  monitored  and  errors  will  be  generated  if  a  port  stops  or  a  low-level  error 
occurs.  Every  one  million  frames,  the  circulating  frames  are  captured  to  verify  that  they  are  still  circulating 
and  that  they  are  still  in-order.  In  this  manner,  the  entire  path  to  the  remote  switch  might  be  verified,  as  can 
be  the  proper  in-order  delivery  operation  of  any  trunk  groups  present. 

The  switch  remains  in  normal  operation  while  this  test  is  running;  however,  some  performance  degradation 
occurs  due  to  the  ISL  links  being  saturated  with  test  frames.  Because  of  this,  you  should  use  caution  when 
running  this  test  on  live  fabrics.  Consider  only  testing  one  trunk  group  or  ISL  link  at  a  time,  and  do  not  run 
the  tests  for  extended  periods  of  time. 

This  test  is  best  combined  with  the  online  crossPortTest  for  ISL  link-failure  isolation.  If  this  test  fails, 
replace  the  cable  with  a  loop-back  plug  and  run  crossPortTest  to  verify  the  local  switch  and  media.  If 
these  pass,  the  fault  lies  in  the  cable  or  remote  switch  and  media. 

The  frames  are  continuously  transmitted  and  received  in  all  ports  in  parallel.  The  port  LEDs  flicker  green 
rapidly  while  the  test  is  running. 


NOTE:    When  trunk  groups  are  present,  the  entire  trunk  group  must  be  included  in  the  range  of  ports  to 
test  or  false  failures  can  occur.  If  multiple  ISL  links  are  present  between  two  switches  that  support  trunking, 
then  it  is  likely  that  trunk  groups  are  present  and  all  ports  between  the  two  switches  should  be  tested  at  the 
same  time. 
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Operands 


This  command  has  the  following  operands: 


-nmegs  count 


-ports  itemlist 


-setfail  mode 


-domain  value 


Specify  in  millions  the  number  of  frames  to  send.  The  test  will  progress 
until  the  specified  number  of  frames  has  been  transmitted  on  each  port. 
The  default  value  is  10  million  frames. 

This  command  only  approximately  counts  the  frames  and  the  actual 
number  of  frames  sent  will  be  slightly  larger,  particularly  at  2  Gb/s  link 
speeds. 

Specify  a  list  of  user  ports  to  test.  By  default,  all  of  the  ISL  ports  in  the 
current  switch  will  be  tested.  Refer  to  itemList  help  pages  for  further 
details. 

Instruct  spinFab  how  to  mark  failed  ports.  If  set  to  1,  it  will  mark 
failing  ports  as  FAILED.  If  set  to  0,  it  will  not  mark  failed  ports  as 
FAILED.  It  is  to  minimize  the  impact  on  live  fabrics.  This  test  normally 
logs  errors  but  does  not  set  the  port  status  to  FAILED.  This  parameter  is 
provided  to  force  the  failing  ports  to  be  marked  as  FAILED  in  the  same 
manner  as  other  diagnostics.  In  test  or  qualification  environments 
without  live  traffic,  this  might  be  useful  with  large  values  of  -nmegs 
count.  This  mode  is  disabled  by  default. 

Specify  a  remote  domain  to  which  the  switch  is  connected.  The  default 
is  to  automatically  determine  the  remote  domain  number.  This  might  not 
work  properly  in  certain  conditions. 


Examples 


To  test  cascading  ISL  links: 


switch: admin>  spinfab  -ports  1/0  -  1/2 
spinfab  running. . . 

spinfab:  Completed  11  megs,   status:  passed. 

port  0  test  status:   0x00000000  --  passed. 

port  1  test  status:   0x00000000  --  passed. 

port  2  test  status:   0x00000000  --  passed. 
Test  Complete:    "spinfab"  Pass  10  of  10 
Duration  0  hr,    0  min  &  41  sec  (0:0:41:877). 
passed. 


Diagnostics 

When  it  detects  failure(s),  the  test  might  report  one  or  more  of  the  following  error  messages: 


DATA 

ERR_ 

_STAT 

ERR_ 

.STATS 

ERR_ 

.STATS. 

.2  LONG 

ERR_ 

.STATS_ 

.BADEOF 

ERR_ 

.STATS_ 

.BADOS 

ERR_ 

.STATS. 

.C3DISC 

ERR_ 

.STATS. 

.CRC 

ERR_ 

.STATS. 

.ENCIN 

ERR_ 

.STATS. 

.ENCOUT 

ERR_ 

.STATS. 

.TRUNC 
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ERR_STAT_2  LONG 

ERR_STAT_BADEOF 

ERR_STAT_BADOS 

ERR_STAT_C3DISC 

ERR_STAT_CRC 

ERR_STAT_ENCIN 

ERR_STAT_ENCOUT 

ERR_STAT_TRUNC 

FINISH_MSG_ERR 

INIT 

MBUF_STATE_ERR 

NO_SEGMENT 

PORT_ABSENT 

PORT_DIED 

PORT_ENABLE 

P0RT_M2M 

PORT_STOPPED 

PORT_WRONG 

RXQ_RAM_PERR 

STATS 

STATS_C3FRX 

STATS_FRX 

STATS_FTX 

TIMEOUT 

XMIT 


Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 


also 

camTest 


centralMemoryTest 

cmemRetentionTest 

cmiTest 

crossPortTest 

itemList 

portLoopbackTest 
spinSilk 

sramRetentionTest 
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spinJitter 


Measures  line-speed  jitter. 


Synopsis 

spinjitter  [--slot  number]  [-nmegs  count]  [-lb_mode  mode]  [-spd_mode  mode] 
[-ports  itemlist] 


Availability 

admin 


Description 

This  test  uses  the  same  procedures  as  spinsilk  but  with  a  special  pattern  for  line-speed  jitter  measurement. 
The  test  uses  the  following  pattern: 

jCRPAT      be  d7  23  47  6b  8f  b3  14  5e  fb  35  59  be  d7  23  47 
For  details  about  the  procedures  used  in  this  test,  refer  to  spinSil]<;. 


Options 


The  following  are  optional:- 


-slot  number 


-nmegs  count 


-lb  mode  mode 


-spd_mode  mode 


Specifies  the  slot  number  on  which  the  diagnostic  operates.  The  ports  specified 
are  relative  to  this  slot  number.  The  default  is  set  to  0  and  designed  to  operate 
on  fixed-port-count  products. 

Specifies  the  number  of  frames  to  send  in  millions.  The  test  progresses  until  the 
specified  number  of  frames  transmits  on  each  port.  The  default  value  is  1 0, 
which  represents  10  million  frames. 

Select  the  loopback  point  for  the  test.  By  default,  spinjitter  uses  port 
loopback. 


0 
1 


Cable  loopback 

Port  loopback  (loopback  plugs) 

External  (SERDES)  loopback 


3  Silkscreen  loopback 

5  Internal  (parallel)  loopback 

Specifies  the  speed  mode  for  the  test.  This  parameter  is  used  for  Bloom  and 
Condor  ASIC-based  products  only,  for  which  it  controls  the  speed  at  which 
each  port  operates.  For  1  G-only  products,  this  parameter  is  ignored.  The  exact 
operation  of  modes  5  through  8  depends  on  the  loopback  mode  selected. 
When  speed  modes  5  through  8  are  used  with  cables,  they  must  be  connected 
EVEN->ODD  or  the  test  fails. 

0  Run  test  at  1  Gb/s,  2  Gb/s,  and  4  Gb/s. 


1 

2 
4 


Run  test  at  1  Gb/s. 

Run  test  at  2  Gb/s.  (Bloom  default) 

Run  test  at  4  Gb/s.  (Condor  default) 
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For  -lb_mode  set  to  0,1,  the  following  speed  modes  are  available  to  test  the 
speed  negotiation. 

3  Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  1  Gb/s. 

4  Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  2Gb/s. 

5  Set  all  odd  ports'  speed  for  autonegotiate.  Set  all  even  ports'  speed 
for  1  Gb/s. 

6  Set  all  odd  ports'  speed  for  autonegotiate.  Set  all  even  ports'  speed 
for  2  Gb/s. 

For  -lb_mode  set  to  2,3,  the  follovving  speed  modes  are  available  to  test  FIFO 
underrun. 

3.5  Set  all  even  ports'  speed  for  2  Gb/s.  Set  all  odd  ports'  speed  for  1 
Gb/s. 

4.6  Set  all  even  ports'  speed  for  1  Gb/s.  Set  all  odd  ports'  speed  for  2 
Gb/s. 

-ports  Specifies  a  list  of  user  ports  to  test.  By  default,  all  the  user  ports  in  the  specified 

itemlist  slot  (--slot)  will  be  used.  Refer  to  ItemList  for  further  details. 

Examples 

To  measure  line-speed  jitter: 


switch : admin> 

spinjitter  -ports  1/0  - 

-  1/2 

Running  SpinJitter   

One  moment  please   . . . Ports  Segmented 

(0) 

switchName : 

SW12000A 

switchType : 

10  . 1 

switchstate : 

Offline 

switchRole : 

Disabled 

switchDomain : 

1  (unconfirmed) 

switchid: 

fffcOl 

switchWwn : 

10:00:00:60:69:80:03 

Oc 

switchBeacon: 

OFF 

bladel :  Beacon 

:  OFF 

blade2 :  Beacon 

:  OFF 

blade3 :  Beacon 

:  OFF 

blade4 :  Beacon 

:  OFF 

Area  Slot  Port 

Gbic  Speed  State 

0  10 

id        2G  Online 

Testing   

111 

id        2G  Online 

Testing   

2  12 

id        2G  Online 

Testing   

(output  truncated) 
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Diagnostics 

When  it  detects  failure(s),  the  test  might  report  one  or  more  of  the  following  error  messages: 

DATA 

EPIl_STATUS_ERR 


ERR_ 

_STAT 

ERR_ 

.STATS 

ERR_ 

.STATS_2L0NG 

ERR_ 

.STATS_BADEOF 

ERR_ 

_STATS_BADOS 

ERR_ 

_STATS_C3DISC 

ERR_ 

.STATS_CRC 

ERR_ 

.STATS_ENCIN 

ERR_ 

.STATS_ENCOUT 

ERR_ 

.STATS_TRUNC 

ERR_ 

_STAT_2L0NG 

ERR_ 

_STAT_BADEOF 

ERR_ 

_STAT_BADOS 

ERR_ 

.STAT_C3DISC 

ERR_ 

.STAT_CRC 

ERR_ 

.STAT_ENCIN 

ERR_ 

_STAT_ENCOUT 

ERR_ 

_STAT_TRUNC 

FDET_PERR 
FINISH_MSG_ERR 
FTPRT_STATUS_ERR 
INIT 

LESSN_STATUS_ERR 

MBUF_STATE_ERR 

MBUF_STATUS_ERR 

NO_SEGMENT 

PORT_ABSENT 

PORT_DIED 

PORT_ENABLE 

P0RT_M2M 

PORT_STOPPED 

PORT_WRONG 

RXQ_FRAME_ERR 

RXQ_RAM_PERR 

STATS 

STATS_C3FRX 

STATS_FRX 

STATS_FTX 

TIMEOUT 

XMIT 

Refer  to  the  HP  SforageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 
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See  also 

backport 
camTest 

centralMemoryTest 

cmemRetentionTest 

cmiTest 

crossPortTest 

itemList 

portLoopbackTest 

portRegTest 

spinSilk 

sramRetentionTest 
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spinSilk 

Performs  a  functional  test  of  internal  and  external  transmit  and  receive  paths  at  full  speed. 

Synopsis 

spinsilk  [-nmegs  count] [-lb_mode  mode]  [-spd_mode  mode]  [-verbose  mode]  [-ports 
i  t  eml ist] 

Availability 

admin 

Description 

This  command  verifies  the  functional  operation  of  the  switch  by  setting  up  the  routing  hardware  so  that 
frames  received  by  port  M  are  retransmitted  through  port  N.  Likewise  frames  received  by  port  N  are 
retransmitted  through  port  M.  Each  port  M  sends  one  frame  to  its  partner  port  N  through  an  external  fiber 
cable,  exercising  all  of  the  switch  components. 


["2^^  NOTE:    The  spinSilk  command  cannot  be  executed  on  an  operational  switch.  You  must  first  disable  the 
switch  using  the  switchDisable  command. 


The  cables  can  be  connected  to  any  port  combination  with  the  condition  that  the  cables  and  SFPs 
connected  are  of  the  same  technology.  For  example,  a  short-wavelength  SFP  port  must  be  connected  to 
another  short-wavelength  SFP  port  through  a  short-wavelength  cable. 

Optimum  test  coverage  occurs  with  lb_mode  1,  m->m  loopback  plugs  and  splbmode  disabled.  In  this 
case  every  port  will  exchange  frames  with  every  other  port  and  all  of  the  ASIC  to  ASIC  connections  are 
tested. 

The  frames  are  continuously  transmitted  and  received  in  all  ports  in  parallel.  The  port  LEDs  flicker  green 
rapidly  while  the  test  is  running. 

At  each  pass,  the  frame  is  created  from  a  different  data  type.  There  are  seven  data  types: 

•  CSPAT:  0x7e,  0x7e,  0x7e,  0x7e,  ... 

•  BYTE_LFSR:  0x69,  0x01,  0x02,  0x05,  ... 

•  CHALF_SQ:  Ox4a,  Ox4a,  Ox4a,  Ox4a,  ... 

•  QUAD_NOT:  0x00,  Oxff,  0x00,  Oxff,  ... 

•  CQTR_SQ:  0x78,  0x78,  0x78,  0x78,  ... 

•  CRPAT:  Oxbc,  Oxbc,  0x23,  0x47,  ... 

•  RANDOM:  0x25,  0x7f,  0x6e,  0x9a,  ... 

If  seven  passes  are  requested,  the  seven  different  data  types  are  used  in  the  test.  If  eight  passes  are 
requested,  the  first  seven  frames  use  unique  data  types,  and  the  eighth  is  the  same  as  the  first. 

spinSilk  modes 

These  are  the  test  modes.  These  modes  can  be  used  together  to  test  specific  ports: 

•  Loopback  mode 

•  SFP  mode 


628   Fabric  OS  commands 


Loopback  mode 

There  are  four  loopback  modes  that  can  be  used  when  executing  the  spinSilk  command.  The  modes 
are  specified  by  entering: 

•  0  for  cable  mode. 

This  loopback  mode  is  the  default  mode  and  tests  only  M->N  connections.  It  requires  that 
the  user  connect  a  cable  from  one  port  to  a  different  port. 

•  1  for  single  port  also  loopback  mode. 

This  loopback  mode  tests  M->N  and  M->M  connections. 

If  M->N  cable  connections  are  used,  the  spinSilk  command  operates  identically  in 

lb_mode  0  and  lb_mode  1. 

If  M->M  loopback  plugs  are  used  with  SPLB  mode  disabled,  the  spinSilk  command  will 
circulate  frames  between  pairs  of  M->M  connected  ports  as  follows: 

PI   TX  >»   PI   RX   ->   P2   TX  »>   P2   RX   ->   PI  TX 

>>>  is  a  cable  or  internal  loopback. 

->  is  a  routing  table  entry. 

The  connections  between  pairs  of  M->M  ports  are  chosen  to  exercise  the  connections 
between  as  many  ASICs  as  possible,  subject  to  the  availability  of  pairs  of  M->M  ports. 

In  mode  1  with  SPLB  mode  disabled,  the  spinSilk  command  only  circulates  frames  within 
each  single  port  and  none  of  the  ASIC  to  ASIC  connections  are  tested.  This  mode  should  be 
used  only  for  fault  isolation. 

•  2  for  external  loopback  mode. 

The  external  loopback  test  creates  a  test  loop  between  two  ports  on  different  ASICs;  it  also 
tests  the  Serializer/Deserializer  (serdes)  functionality. 

•  5  for  internal  loopback  mode. 

The  internal  loopback  test  creates  a  test  loop  between  two  ports  on  a  single  ASIC. 

Refer  to  the  setSplbMode  command  for  more  information  on  how  the  loopback  mode  setting  changes 
the  execution  of  this  command. 

GBIC/SFP  mode 

If  the  spinSilk  command  is  executed  with  GBIC  mode  activated,  only  ports  containing  GBICs  are 
tested.  To  activate  GBIC  mode,  execute  the  following  command  prior  to  executing  the  spinSilk 
command: 


switch :adinin>  setsfpmode 

1 

The  state  of  the  GBIC  mode  is  saved 

in  flash  memory  and  remains  active  over  a  reboot  until  it  is  d 

as  follows: 

switch :admin>  setsfpmode 

0 

Prior  to  running  this  command,  make  sure  you  disable  the  switch,  set  the  GBIC  mode  to  1,  and  install 
loopback  cables  on  all  GBIC  ports  you  want  to  test. 

Because  this  test  includes  the  GBIC  and  the  fiber  cable  in  its  test  path,  use  the  results  from  this  test  in 
conjunction  with  the  results  from  crossPortTest  and  portLoopbackTest  to  determine  those  switch 
components  that  are  not  functioning  properly. 
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Operands 

This  command  has  the  following  operands:- 

-nmegs  count         Specifies  the  number  of  frames  to  send  in  millions.  The  test  progresses  until  the 
specified  number  of  frames  transmits  on  each  port.  The  default  value  is  1 0, 
which  represents  10  million  frames. 

-lb_mode  mode       Select  the  loopback  point  for  the  test.  By  default,  spinJitter  uses  port 
loopback. 

0  Cable  loopback 

1  Port  loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 

3  Silkscreen  loopback 

4  Internal  (parallel)  loopback 

-spd_mode  mode     Specifies  the  speed  mode  for  the  test.  This  parameter  is  used  for  Bloom  and 

Condor  ASIC-based  products  only,  for  which  it  controls  the  speed  at  which  each 
port  operates.  For  IG-only  products,  this  parameter  is  ignored.  The  exact 
operation  of  modes  5  through  8  depends  on  the  loopback  mode  selected. 
When  speed  modes  5  through  8  are  used  with  cables,  they  must  be  connected 
EVEN->ODD  or  the  test  fails. 

For  -lb_mode  set  to  0,1,  the  following  speed  modes  are  available  to  test  the 
speed  negotiation. 

3  Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  1  Gb/s. 

4  Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  2  Gb/s. 

5  5-  Set  all  odd  ports'  speed  for  autonegotiate.  Set  all  even  ports' 
speed  for  1  Gb/ s. 

6  6-  Set  all  odd  ports'  speed  for  autonegotiate.  Set  all  even  ports' 
speed  for  2  Gb/ s. 

For  -lb_mode  set  to  2,3,  the  following  speed  modes  are  available  to  test  FIFO 
underrun. 

3,5  Set  all  even  ports'  speed  for  2  Gb/s.  Set  all  odd  ports'  speed  for  1 

Gb/s. 

4,6 

Set  all  even  ports'  speed  for  1  Gb/s.  Set  all  odd  ports'  speed  for  2 
Gb/s. 

0  Run  test  at  1  Gb/s,  2  Gb/s,  and  4  Gb/s. 

1  Run  test  at  1  Gb/s. 

2  Run  test  at  2  Gb/s  (Bloom  default). 

3  Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  1  Gb/s. 

4  In  test  at  4  Gb/s  (Condor  default). 

--verbose  mode  Specify  a  nonzero  value  to  display  more  detailed  information  during 

the  test.  This  mode  should  be  used  for  debugging  purposes.  This 
operand  is  optional. 
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-ports 
i  temlist 


Specify  a  list  of  user  ports  to  test.  By  default,  all  of  the  user  ports  i 
the  current  switch  are  tested.  This  option  might  be  used  to  restrict 
testing  to  the  specified  ports. 


Examples 

To  run  spinSilk  on  a  switch: 


switch '.  3.<3iin.iri> 

spinsilk  -ports  1/0  - 

1/9 
J.  /  Z 

Running'  Spin  S 

ilk   

OnG  momsn t  pis 

ase   . . . Ports 

Segmented 

switcliN9.rQ€ : 

switch 

switchTyps : 

10  . 1 

switcliSta.ts : 

Offline 

switchRole : 

Disabled 

switchDomain : 

1  (unconfi 

rmed) 

switchid: 

fffcOl 

switchWwn : 

10:00:00:6 

0:69:80:03 

:0c 

OFF 

:  OFF 

:  OFF 

blade3 :  Beacon 

:  OFF 

blade4 :  Beacon 

:  OFF 

Area  Slot  Port 

Gbic  Speed 

State 

0  10 

id  2G 

Online 

Testing   

111 

id  2G 

Online 

Testing   

2  12 

id  2G 

Online 

Testing   

(output  trunca 

ted) 

Diagnostics 

Following  are  the  possible  error  messages  if  failures  are  detected: 

DATA 

EPI1_STATUS_ERR 

ERR_STAT 

ERR_STATS 

ERR_STATS_2  LONG 

ERR_STATS_BADEOF 

ERR_STATS_BADOS 

ERR_STATS_C3DISC 

ERR_STATS_CRC 

ERR_STATS_ENCIN 

ERR_STATS_ENCOUT 

ERR_STATS_TRUNC 

ERR_STAT_2  LONG 

ERR_STAT_BADEOF 

ERR_STAT_BADOS 
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ERR_STAT_C3DISC 

ERR_STAT_CRC 

ERR_STAT_ENCIN 

ERR_STAT_ENCOUT 

ERR_STAT_TRUNC 

FDET_PERR 

FINISH_MSG_ERR 

FTPRT_STATUS_ERR 

INIT 

LESSN_STATUS_ERR 

MBUF_S  TATE_ERR 

MBUF_STATUS_ERRBAR> 

NO_S FOMENT 

PORT_ABSENT 

PORT_DIED 

PORT_ENABLE 

P0RT_M2M 

PORT_STOPPED 

PORT_WRONG 

RXQ_FRAME_ERR 

RXQ_RAM_PERR 

STATS 

STATS_C3FRX 

STATS_FRX 

STATS_FTX 

TIMEOUT 

XMIT 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

backport 
camTest 

centralMemoryTest 

cmemRetentionTest 

cmiTest 

crossPortTest 

itemList 

portLoopbackTest 
portRegTest 
spinJitter 
sramRetentionTest 
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sramRetentionTest 


Performs  a  data  retention  test  of  the  miscellaneous  SRAMs  in  ASIC. 

Synopsis 

sramretentiontest    [--slot  slotnumber]  [-passcnt  count] [-ports 
itemlist]  [-skip  bitmask]  [-delay  value] 

Availability 

admin 

Description 

Use  this  command  to  verify  that  data  written  into  the  miscellaneous  SRAMs  in  the  ASIC  are  retained  after 
a  1 0-second  wait.  The  method  used  is  to  write  a  fill  pattern  to  all  SRAMs,  wait  1 0  seconds,  and  then  read 
all  SRAMs,  checking  that  the  data  read  matches  the  data  previously  written.  The  test  is  repeated  using  the 
inverted  version  of  the  pattern.  The  test  will  use  four  QUAD  FILL  patterns  and  one  QUAD_RAMP  pattern 
with  random  seed.  The  first  four  QUAD_FILL  patterns  are: 

Oxf ff ff fff 
0x55555555 
0x33333333 
OxOf Of Of Of Of 

For  details  about  the  patterns  used  in  diagnostic  tests,  refer  to  the  dataTypeShow  command. 

'2^^  NOTE:    The  sramRetentionTest  command  cannot  be  executed  on  an  operational  switch.  You  must 
first  disable  the  switch  using  the  switchDisable  command. 


Operands 

This  command  has  the  following  operands: 

--slot  slotnumber     Specify  the  number  of  the  slot  on  which  the  diagnostic  operates.  The  ports 

specified  are  relative  to  this  slot  number.  The  default  is  set  to  0  and 
designed  to  operate  on  fixed-port-count  products. 

-passcnt  count  Specify  the  number  of  times  to  execute  this  test.  The  default  value  is  1 . 

-ports  itemlist         Specify  a  list  of  blade  ports  to  test.  By  default,  all  the  blade  ports  in  the 

specified  slot  are  used.  Refer  to  itemList  for  more  details. 

-skip  bitmask  Specify  a  patterns  to  omit  in  the  test.  This  command  uses  the  data  patterns 

described  earlier  by  default.  Using  this  option,  the  user  can  intentionally 
omit  one  or  more  pattern(s)  if  needed. 

-delay  value  Specify  the  delay  between  the  read  and  write,  in  seconds.  The  default  value 

is  1 0  seconds. 

Examples 

To  run  a  data  retention  test: 

switch :  adinin>  sramretentiontest  2 
Running  SRAM  Retention  Test  . . .  passed. 
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Diagnostics 

Following  are  the  possible  error  messages  if  failures  are  detected: 

BUS_TIMEOUT 

REGERR 

REGERR_UNRST 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

camTest 

centralMemoryTest 

cmiTest 

crossPortTest 

dataTypeShow 

itemList 

portLoopbackTest 
spinSilk 
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statsClear 

Clears  port  and  diagnostic  statistics. 

Synopsis 

statsclear   [--slot  slotnumber]    [-uports  itemlist]    [-bports  itemlist] 
[-use_bports  value] 

Availability 

admin 

Description 

Use  this  command  to  clear  the  port  and  diagnostics  statistics  for  the  specified  list  of  blade  or  user  ports. 

Options 

The  following  are  optional: 

--slot  slotnumber     Specifies  the  slot  on  which  to  operate.  If  this  option  is  not  specified,  the 

default  slot  is  assumed.  The  default  slot  is  0  and  designed  to  operate  on 
fixed-port-count  products,  if  -use_bports  sets  with  nonzero  value. 

-uports  itemlist       Specifies  the  list  of  user  ports  to  clear. 

-bports  itemlist       Specifies  the  list  of  blade  ports  to  clear. 

-use_bports  value     If  value  is  nonzero,  then  the  diagnostics  statistics  for  the  blade  ports 

specified  in  -bports  clears;  otherwise,  the  user  ports  specified  in  -uports 
clears.  The  default  value  is  0. 

Examples 

To  clear  port  and  diagnostic  statistics: 

switch:admin>  statsclear  -bports  1/10-1/62  -use_bports  1 

See  also 

itemList 
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statsTest 


Runs  a  statistics  counter  diagnostic  test. 


Synopsis 


statstest   [-passcnt  count]  [-ports  itemlist] 


Availability 


admin 


Description 


Use  this  command  to  verify  the  2  Gb/s  ASIC  statistics  counter  logic.  It  can  run  on  every  base  port  of  the 
quadrant  and  send  the  frame  through  internal  loopback  with  no  CRC  data  to  induce  the  CRC  error.  This 
command  is  also  run  from  camTest. 

This  test  covers  the  following  statistics  counter  functionality: 

•  The  number  of  received  frames  with  CRC  errors  that  matched  the  SID-DID  pair  specified  in  the  LINK 
table.  There  are  1 6  of  these  statistics  counters  (0-1 5). 

•  The  number  of  received  words  in  frames  that  matched  the  SID-DID  pair  specified  in  the  LINK  table. 
There  are  1 6  of  these  statistics  counters  (0-15). 

•  The  number  of  transmitted  words  in  frames  that  matched  the  SID-DID  pair  specified  in  the  LINK  table. 
There  are  1 6  of  these  statistics  counters  (0-1 5). 

•  The  number  of  frames  with  CRC  error  that  matched  the  corresponding  ALI  (0-1  27),  respectively. 

This  command  cannot  be  executed  on  an  operational  switch.  You  must  first  disable  the  switch  using  the 
switchDisable  command. 


r2^^  NOTE:  There  is  a  link  table  that  stores  1 6  pairs  of  SID-DID  address.  Each  of  the  SID-DID  pairs  is  named  a 
li— I    link.  This  table  is  used  for  gathering  statistics  that  match  the  link. 


Operands 

This  command  has  the  following  optional  operands: 


-passcnt  count 


Specify  the  number  of  times  to  perform  this  test.  The  default  value 


is  1. 


ports  itemlist 


Specify  a  list  of  user  ports  to  run  the  test.  If  omitted,  all  the  user 
ports  in  the  switch  are  assumed.  Refer  to  itemList  for  more 
information  about  selecting  ports. 


Examples 


To  run  a  statistics  counter  test  on  a  switch: 


switch: admin>  statstest  -passcnt  1  -ports  1/0-15 


Running  Statistics  Counter  Test 


passed. 
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Diagnostics 

When  it  detects  failures,  the  subtest  reports  one  or  more  of  the  following  error  messages: 


DIAG-STSINIT 

DIAG-STSNULL 

DIAG-STSSID 

DIAG-STSXMIT 

DIAG-STSRCV 

DIAG-STSFRMCNT 

DIAG-STSWRDCNT 

DIAG-STSALPACNT 


Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 


See  also 

camTest 
itemList 
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stopPortTest 

Terminates  the  running  portTest. 

Synopsis 

stopporttest    [-ports  itemlist] 

Availability 

admin 

Description 

Use  this  command  to  stop  the  currently  running  portTest.  Refer  to  the  portTest  command  for  more 
information. 

If  portTest  is  running  on  a  non-singlemode,  use  to  stop  the  test. 

Operands 

This  command  has  the  following  operand: 

-ports  i  temlist         Specify  a  list  of  user  ports  to  test.  By  default,  all  the  user  ports  in  the  current 

slot  are  be  assumed.  Refer  to  itemList  help  pages  for  further  details. 

Examples 

To  stop  the  portTest  command: 

switch: admin>  stopporttest 

See  also 

crossPortTest 

fportTest 

loopPortTest 

portLoopbackTest 

portTest 

portTestShow 

spinFab 
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supportFtp 

Sets,  clears,  or  displays  support  FTP  parameters,  or  a  time  interval  to  check  the  FTP  server. 

Synopsis 

supportftp  [-S] 

supportftp  -s    [-h  hostip]    [-u  username]    [-p  password]    [-d  remotedirectory ] 

supportftp  -t  liours 

supportftp  -R 

Availability 

admin 

Description 

Use  this  command  to  set,  clear,  or  display  support  FTP  parameters,  or  a  time  interval  to  check  the  FTP 
server. 

NOTE:    If  there  is  no  parameter  specified,  this  command  defaults  to  supportFtp  -S  . 


Operands 

This  command  has  the  follov/ing  mutually  exclusive  operands: 

--S  Displays  FTP  parameters. 

--S  Sets  FTP  parameters,  -s  has  the  follov/ing  optional  operands: 

li  hostip  Specifies  FTP  host  IP  address.  It  must  be  an  IP 

address. 

u  username  Specifies  FTP  user  name. 

-p  password  Specifies  FTP  user  password.  If  the  user  name  is 

anonymous,  the  password  is  not  needed. 

-d  remotedirectory      Specifies  remote  directory  to  store  trace  dump  files. 

--t  Sets  time  interval  to  check  FTP  server,  -t  has  the  following  required  operands: 

hours  Checks  the  connectivity  of  FTP  server  at  the 

indicated  time  interval  (in  hours). 

-R  Clears  FTP  parameters. 

Examples 

To  set  the  FTP  parameters: 

switch : adinin>  supportftp  -s  -h  192.168.67.126  -u  anonymous  -d  tracedump 
supportftp:    ftp  parameters  changed. 
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To  display  a  time  interval  to  check  the  FTP  server: 

switch : admin>  support ftp  -t  24 
supportftp:   ftp  check  period  changed. 

See  also 

supportSave 

supportShow 

traceDump 

traceFtp 

traceTrig 
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supportSave 


Saves  support  information  for  RASLOG,  TRACE,  and  supportShow. 


Synopsis 


supportsave   [-n]    [-c]    [-u  user_naine  -p  password]    -h  host_ip  -d  remote_dir 


Availability 

admin 


Description 

Use  this  command  to  save  RASLOG,  TRACE,  and  supportShow  (active  CP  only)  information  for  the  local 
CP  to  a  remote  FTP  location.  If  no  operands  are  specified,  this  command  enters  interactive  mode.  The 
following  output  files  are  generated: 


RASLOG 
TRACE 

supportShow 


switchname-slot-YYYYMMDDHHMM-errDumpAll.ss 

switchname-slot-YYYYMMDDHHMM-fracedump.dmp 

switchname-slot-YYYYMMDDHHMM-supportShow  (saved  in  the  specified 
remote  directory) 


Operands 


The  operands  are  as  follows: 


-c 


-u  user_name 

-p  password 

-h  host_ip 
-d  reinote_dir 


Does  not  prompt  the  user  for  confirmation.  This  operand  is  optional;  if 
omitted,  the  user  is  prompted  for  confirmation. 

Uses  the  FTP  parameters  saved  by  the  command  supportFtp.  This  operand 
is  optional;  if  omitted,  specify  the  FTP  parameters  through  command  line 
options  or  interactively.  To  display  the  current  FTP  parameters,  run 

supportFtp  (on  a  dual  CP  system,  run  supportFtp  on  the  active  CP). 

NOTE:   The  -c  operand  is  mutually  exclusive  with  -u,  -p,  -h,  and  -d. 

Specifies  the  user  name  for  the  FTP  server.  This  operand  is  optional;  if 
omitted,  anonymous  FTP  is  used. 

Specifies  the  password  for  the  FTP  server.  This  operand  is  optional;  if  omitted, 
anonymous  FTP  is  used. 

Specifies  the  IP  address  for  the  FTP  server. 

Specifies  the  remote  directory  for  the  FTP  server. 
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Examples 

To  save  RASLOG,  TRACE,  and  supportShow  information  to  a  FTP  server  in  non-interactive  mode: 

switch : admin>  supportsave  -n  -u  admin  -p  pass  -h  192.168.1.1  -d  tmp 
Saving  support  information  for  module  RASLOG. . . 


. . .ortSave  f iles/switch-S5-200405200010-errDumpAll . ss : 
566.47  B/s 

1.66 

kB 

Saving  support  information  for  module  TRACE... 

. . .ortSave_files/switch-S5-200405200010-tracedump.dmp: 
a  4  b . 0  U   KB  /  s 

10  .00 

MB 

Saving  support  information  for  module  SUPPORTSHOW. . . 

. . .rtSave  f iles/switch-S5-200405200014-supportShow. ss : 
346.39  kB/s 

1 . 11 

MB 

To  save  RASLOG,  TRACE,  and  supportShow  information  to  a  FTP  server  in 

interactive  mode: 

switch: admin>  supportsave 

This  command  will  collect  RASLOG,   TRACE,   and  supportShow  (active  CP 
only)    information  for  the  local  CP  and  then  transfer  them  to  a  FTP 
server.  The  operation  can  take  several  minutes.  OK  to  proceed?   (yes,  y, 
no,   n)  :    [no]  y 

Host  IP: 

192 . 168  . 1 . 1 

User  Name:  admin 

Password: 

Remote  Directory:  tmp 

Saving  support  information  for  module  RASLOG. . . 

. . .ortSave  f iles/switch-S5-200405200010-errDumpAll . ss : 
566.47  B/s 

1.66 

kB 

Saving  support  information  for  module  TRACE... 

. . .ortSave  files /switch-S5-2 004052 00010-tracedump . dmp : 
848.00  kB/s 

10.00 

MB 

Saving  support  information  for  module  SUPPORTSHOW. .  . 

. . .rtSave  f iles/switch-S5-200405200014-supportShow.  ss  : 
346.39  kB/s 

1 . 11 

MB 

See  also 

supportFtp 

supportShow 

traceDump 

traceFtp 

traceTrig 
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supportShow 

Prints  switch  information  for  debugging  purposes. 

Synopsis 

supportshow   [ [slotnumber/] portnumberl-portnuraber2]  [lines] 

Availability 

all  users 

Description 

Use  tfiis  command  to  display  support  information  from  groups  of  preselected  Fabric  OS  and  Linux 
commands.  You  can  specify  the  range  of  ports  for  which  this  information  displays.  These  commands  are 
organized  by  groups,  but  note  that  the  order  of  the  groups  listed  next  is  not  the  same  as  executed  by  the 
command. 

Refer  to  Chapter  7,  for  more  information. 

The  commands  can  be  arranged  in  groups,  as  follows: 

•  OS  (ENABLED  by  default;  Linux  commands  are  not  documented  in  this  manual) 

•  mii-tool 

•  du 

•  ps 

•  rpm 

•  dmesg 

•  fstab 

•  mtab 

•  various  proc  entries 

•  find  core  files 

•  exception  (ENABLED  by  default) 

•  errDump 

•  pdShow 

•  port  (ENABLED  by  default) 

•  diagShow  (per-slot) 

•  portShow  (per-slot) 

•  portLoginShow  (per-slot) 

•  portRegTest  (per-slot) 

•  portRouteShow  (per-slot) 

•  fabric  (ENABLED  by  default) 

•  fabricShow 

•  islShow 

•  trunkShow 

•  topologyShow 

•  LSDbShow 

•  ess  show 

•  fabStateShow 

•  f abSwitchShow 
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•  fabPortShow 

•  fspfShow 

•  fcpLogShow 

•  zone  stateshow 

•  portZoneShow 

•  portCamShow 

•  cfgShow 

•  cfgSize 

•  rcssmshow 

•  rcsInfoShow 

•  rcsregistryshow 

•  zone  mergeshow 

•  services  (ENABLED  by  default) 

•  f dmiCacheShow 

•  fdmiShow 

•  nsShow 

•  nsAllShow 

•  nscamShow 

•  security  (ENABLED  by  default) 

•  authUtil 

•  secFabricShow 

•  secGlobalShow 

•  secModeShow 

•  secStatsShow 

•  network  (ENABLED  by  default) 

•  bootenv 

•  sin 

•  df 

•  ifconfig 

•  route 

•  hostname 

•  portlog  (ENABLED  by  default) 

•  portLogDump 

•  system  (ENABLED  by  default) 

•  my  Id 

•  version 

•  firmwareShow 

•  upTime 

•  switchStatusShow 

•  switchShow 

•  haDump  (includes  haShowand  ipAddrShow) 

•  tempShow 

•  sensorShow 

•  psShow 

•  licenseShow 
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•  portFlagsShow 

•  portCfgShow 

•  portErrShow 

•  fwSamShow 

•  agtCfgShow 

•  slotShow  (product-dependent) 

•  emtraceshow 

•  systraceshow  -d 

•  fwAlarmsFilterShow 

•  chassisShow 

•  timeout 

•  historyShow 

•  portSwapShow 

•  configShow 

•  extend  (DISABLED  by  default) 

•  buffers  (per-port) 

•  credits  (per-port) 

•  data  (per-port) 

•  phantom  (per-port) 

•  properties  (per-port) 

•  statistics  (per-port) 

•  filter  (DISABLED  by  default;  this  group  has  lengthy  output) 

•  filterportshow  (per-port) 

•  perfmon  (DISABLED  by  default) 

•  ps_dump  (per-port;  this  group  has  lengthy  output) 

Operands 

This  command  has  the  following  operands: 

slotnumber/ portnumberl     Specify  the  range  of  ports  to  display.  If  the 
-portnumber2  slotnumber/portnumber  parameter  is  omitted,  all  ports 

in  the  switch  display  in  the  per-port  outputs.  The 
slotnumber  must  be  provided  when  specifying  a  range  of 
ports  on  multi-bladed  products. 

lines  Specifies  the  number  of  lines  of  portLogDump  output  to 

display.  If  this  parameter  used,  the 
slotnumber/portnumber  parameter  is  required. 
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Examples 


To  display  switch  information  for  debugging: 


switch: admin>  supportshow  1/1-3 
supportshow  groups  enabled:  system 
version : 

Kernel:  2.4.19 
Fabric  OS:     v4 . 1 . 0 

Made  on:  Fri  Jan  10  01:06:10  2003 
Flash:  Thu  Jan  17  00:06:52  2003 

BootProm:  3.2.1 


uptime : 

10:49am  up 

3:25,     1  us 

switchshow: 

switchName : 

switch 

switchType : 

10  . 1 

switchState : 

Online 

switchMode : 

Native 

switchRole : 

Principal 

switchDomain : 

1 

switchid : 

ff fcOl 

switchWwn : 

10:00:00: 

zoning : 

OFF 

switchBeacon: 

OFF 

bladel  Beacon 

OFF 

(output  truncated) 


See  also 


supportFtp 

supportSave 

supportShowCfgDi sable 

supportShowCf gEnable 

supportShowCf gShow 

traceDump 

traceFtp 

traceTrig 
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supportShowCfgDisable 

Disables  a  group  of  commands  under  the  supportShow  command. 

Synopsis 

supportshowcf gdisable  [os  |  exception  |  port  |  fabric  |  services  |  security 
I   network   |   portlog   |    system  extend   |    filter   |   perfmon  ] 

Availability 

admin 

Description 

Use  this  command  to  disable  a  group  of  commands  under  the  supportShow  command.  Use  the 
supportShowCf  gEnable  command  to  enable  groups  of  commands.  Refer  to  Chapter  7  for  more 
information. 

Operands 

This  command  has  the  following  operands: 


OS 

Disables 

the  OS  group  commands 

exception 

Disables 

the  exception  group  commands 

port 

Disables 

the  port  group  commands 

fabric 

Disables 

the  fabric  group  commands 

services 

Disables 

the  service  group  commands 

security 

Disables 

the  security  group  commands 

network 

Disables 

the  network  group  commands 

portlog 

Disables 

the  portlog  group  commands 

system 

Disables 

the  system  group  commands 

extend 

Disables 

the  extend  group  commands 

filter 

Disables 

the  filter  group  commands 

perfmon 

Disables 

the  Performance  Monitor  group  commands 

Examples 

To  disable  the  OS  group  of  commands  under  the  supportShow  command: 

switch :adinin>  supportshowcf gdisable  os 
Config  update  Succeeded 

See  also 

supportShow 
supportShowCf gEnable 
supportShowCf gShow 
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supportShowCfgEnable 

Enables  a  group  of  commands  under  the  supportShow  command. 

Synopsis 

supportshowcf genable  [os  |  exception  |  port  |  fabric  |  services  |  security  | 
network   |   portlog   |   system  extend   |    filter   |   perfmon  ] 

Availability 

admin 

Description 

Use  this  command  to  enable  a  group  of  commands  under  the  supportShow  command.  Use  the 

supportShowCf  gDisable  command  to  disable  groups  of  commands. 

Refer  to  Chapter  7  for  more  information. 

Operands 

This  command  has  the  following  operands: 


OS 

Enables 

the  OS  group  commands 

exception 

Enables 

the  exception  group  commands 

port 

Enables 

the  port  group  commands 

fabric 

Enables 

the  fabric  group  commands 

services 

Enables 

the  service  group  commands 

security 

Enables 

the  security  group  commands 

network 

Enables 

the  network  group  commands 

portlog 

Enables 

the  portlog  group  commands 

system 

Enables 

the  system  group  commands 

extend 

Enables 

the  extend  group  commands 

filter 

Enables 

the  filter  group  commands 

perfmon 

Enables 

the  Performance  Monitor  group  commands 

Examples 

To  enable  a  group  of  commands  under  the  supportShow  command: 

switch : admin>  supportshowcf genable  os 
Config  update  Succeeded 

See  also 

supportShow 
supportShowCf gDisable 
supportShowCf gShow 
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supportShowCfgShow 

Displays  the  groups  of  commands  enabled  for  display  by  the  supportShow  command. 

Synopsis 

supportshowcf gshow 

Availability 

admin 

Description 

Use  this  command  to  display  the  groups  of  commands  enabled  for  display  by  the  supportShow 
command.  Use  the  supportShowCf  gEnable  and  the  supportShowCf  gDisable  commands  to 
modify  which  groups  are  displayed. 

Refer  to  Chapter  7  for  more  information. 

Operands 

none 

Examples 

To  display  which  groups  of  commands  are  enabled  in  the  supportShow  command: 
switch :admin>  supportshowcf gshow 


OS 

enabled 

exception 

enabled 

port 

enabled 

fabric 

enabled 

services 

enabled 

security 

enabled 

network 

enabled 

portlog 

enabled 

system 

enabled 

extend 

disabled 

filter 

disabled 

perfmon 

disabled 

See  also 

supportShow 
supportShowCf gDisable 
supportShowCf gEnable 
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switchBeacon 


Sets  switch  beaconing  mode  on  or  off. 

Synopsis 

switchbeacon  [mode] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  switch  beaconing  mode. 

When  beaconing  mode  is  turned  on,  the  port  LEDs  flash  amber,  left  to  right  and  right  to  left,  which 
continues  until  turned  off  by  the  user.  The  pattern  continues  until  the  user  turns  it  off.  This  can  be  used  to 
beckon  the  user  to  a  failing  unit,  for  example. 

Beaconing  mode  affects  only  the  port  LEDs.  Other  commands  are  still  executable  and  functional.  The 
normal  flashing  LED  pattern  (associated  with  an  active,  faulty,  or  disabled  port)  is  suppressed  and  the 
beaconing  pattern  is  shown.  However,  if  diagnostic  frame-based  tests  (portLoopbackTest, 
crossPortTest,  and  spinSilk)  are  executed,  two  patterns  are  interleaved.  The  diagnostic  test  flickers 
the  LEDs  green  and  simultaneously  the  beaconing  mode  runs  the  LEDs  amber. 

Use  the  switchShow  command  to  display  the  status  of  beaconing. 

Operands 

This  command  has  the  following  operand: 

mode  Specify  1  to  enable  beacon  mode  or  0  to  disable  beacon  mode. 

This  operand  is  optional.  If  no  operand  is  specified,  the  current 
value  is  displayed. 

Examples 

To  turn  beaconing  mode  on: 

switch : admin>  switchbeacon  1 

To  turn  beaconing  mode  off: 

switch :  adinin>  switchbeacon  0 

See  also 

switchShow 


650   Fabric  OS  commands 


switchCfgPersistentDisable 


Disables  a  switch  persistently. 


Synopsis 

switchcf gpersistentdisable 

Availability 

admin 

Description 

Use  this  command  to  persistently  disable  the  switch.  All  Fibre  Channel  ports  are  taken  offline.  If  the  switch 
was  part  of  a  fabric,  the  remaining  switches  reconfigure.  The  switch  remains  disabled  even  after  a  reboot. 

The  disable  process  can  be  observed  and  verified  by  watching  the  front  panel  LEDs  change  to  slow 
flashing  yellow  as  each  port  is  disabled. 

A  persistently  disabled  switch  can  be  temporarily  enabled  using  the  switchEnable  command.  A 
temporarily  enabled  switch  remains  disabled  after  a  reboot. 


\^^)f  NOTE:    Performance  Monitoring  cannot  be  added  to  any  port  on  a  persistently  disabled  switch. 


Operands 


none 


Examples 


To  disable  a  switch  persistently: 


switch:  ad[nin>  switchcf  gpersistentdisable 


See  also 


switchDi sable 


switchEnable 


switchcf gPers is tentEnable 


switchShow 
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switchCfgPersistentEnable 

Enables  a  switch  persistently. 

Synopsis 

switchcf gpersistentenable 


Availability 

admin 

Description 

Use  this  command  to  persistently  enable  the  switch.  All  Fibre  Channel  ports  which  did  not  fail  power-on 
self-test  (POST)  are  enabled,  and  can  come  online  if  connected  to  a  device,  or  remain  offline  if 
disconnected.  The  switch  might  need  to  be  enabled  if  it  was  previously  disabled  to  make  configuration 
changes  or  to  run  diagnostics. 

If  the  switch  is  connected  to  a  fabric,  it  rejoins  the  fabric.  After  this  command  is  issued,  the  1 0  second 
fabric  stability  count  down  is  displayed.  If  this  switch  remains  the  principal  switch  at  the  end  of  the  count 
down,  then  it  assigns  itself  a  domain  ID.  If  another  switch  assumes  the  principal  role,  then  this  switch 
becomes  a  subordinate  switch,  and  accepts  a  domain  ID  from  the  principal.  Refer  to  FC-SW  for  a 
complete  description  of  this  process. 

The  enable  process  can  be  observed  and  verified  by  watching  the  front  panel  LEDs  change  from  slow 
flashing  yellow  as  each  port  is  enabled.  The  LEDs  change  to  green  for  online  ports,  or  can  remain  black 
for  disconnected  ports,  or  yellow  for  ports  that  do  not  initialize. 

Operands 

none 

Examples 

To  configure  the  switch  as  persistently  enabled: 

switch : admin>  switchCfgPersistentEnable 
10  987654321 
fabric:   Principal  switch 
fabric:  Domain  1 


See  also 

switchDi sable 
switchEnable 

switchcf gPers is tentDisable 
switchShow 
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switchCfgSpeed 


Configures  all  ports  of  a  switch  to  a  particular  speed. 

Synopsis 

switchcf gspeed  speed_level 

Availability 

admin 

Description 

Use  tfiis  command  to  configure  the  speed  of  all  the  ports  on  a  switch  to  a  particular  level.  The 
configuration  is  saved  in  flash  memory  and  persists  across  switch  reboot  or  power  cycle. 

The  output  of  portShow  displays  the  achieved  speed  level  and  portCf  gShow  displays  the  user's 
desired  speed  setting. 

Operands 

This  command  has  the  following  required  operand: 

speed_level  Specify  the  speed  of  a  port.  Valid  values  are  one  of  the  following: 

0  Auto  sensing  mode.  The  port  automatically  configures  for  the 
highest  speed. 

1  1-Gb/s  mode.  The  port  is  fixed  at  1  Gb/s. 

2  2-Gb/s  mode.  The  port  is  fixed  at  2  Gb/s. 

Examples 

To  set  the  speed  level  for  all  ports  on  a  switch: 

switch :  adinin>  switchcf  gspeed  0 
Committing  configuration ...  done . 

See  also 

portCf gSpeed 
portShow 
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switchCfgTrunk 

Enables  or  disables  trunking  on  all  the  ports  of  a  switch. 

Synopsis 


switchcf gtrunk  mode 


Availability 

admin 


1^)f  NOTE:   This  command  requires  an  HP  ISL  Trunking  license. 


Description 

Use  this  command  to  enable  or  disable  trunking  on  all  the  ports  of  a  switch. 

Operands 

This  command  has  the  following  operand: 

mode  Specify  1  to  enable  beacon  mode  or  0  to  disable  beacon  mode.  This 

operand  is  optional.  If  no  operand  is  specified,  the  current  value  is 
displayed. 

Examples 

To  enable  trunking  on  a  switch: 

switch : admin>  switchcf gtrunk  0 
Committing  configuration ...  done . 

See  also 

portCf gShow 
portCf gTrunkPort 
portShow 
switchShow 
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switchDisable 

Disables  the  switch. 

Synopsis 

switchdi sable 

Availability 

admin 

Description 

Use  this  command  to  disable  the  switch.  All  Fibre  Channel  ports  are  taken  offline;  if  the  switch  was  part  of 
a  fabric,  the  remaining  switches  reconfigure. 

The  switch  must  be  disabled  before  making  configuration  changes  (using  configure  or 

conf  igDef  ault)  or  before  running  many  of  the  diagnostic  tests.  All  commands  that  require  the  switch  to 

be  disabled  send  an  error  if  invoked  while  the  switch  is  enabled. 

The  switch  does  not  need  to  be  disabled  before  rebooting  or  powering  off. 

As  each  port  is  disabled,  the  front  panel  LED  changes  to  a  slow  flashing  yellow. 

Operands 

none 

Examples 

To  disable  the  switch: 

switch : admin>  switchdisable 

See  also 

switchCf gPersistentDisable 
switchCf gPersistentEnable 
switchEnable 
switchShow 
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switchEnable 

Enables  the  switch. 

Synopsis 

switchenable 

Availability 

admin 

Description 

Use  this  command  to  enable  the  switch.  All  Fibre  Channel  ports  that  passed  POST  are  enabled.  They  can 
come  online  if  connected  to  a  device,  or  will  remain  offline  if  disconnected.  Use  switchEnable  if  you 
disable  the  switch  to  make  configuration  changes  or  to  run  diagnostics. 

If  the  switch  is  connected  to  a  fabric,  it  rejoins  the  fabric.  When  this  command  is  issued,  the  1 0-second 
fabric  stability  countdown  is  displayed.  If  this  switch  remains  the  principal  switch  at  the  end  of  the 
countdown,  then  it  assigns  itself  a  domain  ID.  If  another  switch  assumes  the  principal  role,  then  this  switch 
becomes  a  subordinate  switch  and  accepts  a  domain  ID  from  the  principal.  Refer  to  FC-SW  for  a  complete 
description  of  this  process. 

As  each  port  is  enabled,  the  front  panel  LED  changes  to  green  for  online  ports,  black  for  disconnected 
ports,  or  yellow  for  uninitialized  ports. 

Operands 

none 

Examples 

To  enable  a  switch: 

switch : admin>  switchenable 
10  987654321 
fabric:   Principal  switch 
fabric :   Domain  1 

See  also 

switchCf gPersistentDisable 
switchCf gPersistentEnable 
switchDi sable 
switchShow 
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switchName 


Displays  or  sets  the  switch  name. 

Synopsis 

switchname  [name] 

Availability 

all  users  (display) 

admin  (set) 
Description 

Use  this  command  to  display  or  set  the  switch  name.  All  switches  have  a  symbolic  name  that  is  primarily 
used  for  switch  management.  This  name  is  also  shown  in  the  Fabric  OS  CLI  prompt,  under  each  switch 
icon  on  the  Fabric  Web  page,  and  in  the  output  of  various  Fabric  OS  commands,  such  as  f  abricShow. 

Use  this  command  with  the  name  operand  to  assign  a  new  switch  name.  Enter  this  command  with  no 
operand  to  display  the  current  switch  name. 

Changing  the  switch  name  causes  a  domain  address  format  RSCN  to  be  issued  (refer  to  FC-FLA  for  a 
description  of  RSCNs). 

The  switch  name  also  can  be  changed  using  HP  Advanced  Web  Tools. 
Operands 

This  command  has  the  following  optional  operand: 
name  Specify  a  new  name  for  the  switch.  The  operand  name: 

•  Can  include  up  to  1 5  characters 

•  Must  begin  with  a  letter 

•  Must  consist  of  letters,  digits,  and  underscore  characters,  and 
no  spaces. 

If  this  operand  is  omitted,  this  command  displays  the  current 
switch  name. 

Examples 

To  change  a  switch  name  to  antina  (note  the  change  in  the  prompt  text): 


switch 

adinin> 

switchname  antina 

antina 

adinin> 

switchname 

antina 

See  also 

chassisShow 
switchShow 
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switchReboot 

Halts  the  operational  Core  Switch  2/6A. 

Availability 

admin 

Description 

This  command  reboots  the  operational  switch  without  disrupting  the  other  switch  in  a  dual-switch  chassis. 
This  command  is  equal  to  running  switchShutdown  and  switchStart. 

NOTE:   This  command  is  not  supported  on  single-domain  systems. 

Operands 

none 

Examples 

To  reboot  an  operational  switch: 


switch : admin>  switchreboot 

Stopping  all  switch  daemons 

. . Done 

Powering  off  slot  l...Done. 

Powering  off  slot  4... Done. 

Checking  all  slots  are  powered  off 

. . Done . 

Cleaning  up  kernel  modules . 

. Done . 

Initializing  kernel  modules 

. . Done 

Starting  all  switch  daemons 

. . Done 

Powering  on  slot  l...Done. 

Powering  on  slot  4... Done. 

Checking  diagnostics  ...  Done 

setup  FCIP  IP:   ifconfig  fcO 

ip=0 . 0 

0.0,   netmask=255 . 255 . 255  .  0 

See  also 

switchShutdown 
switchStart 
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switchShow 

Displays  switch  and  port  status. 

Synopsis 

switchshow  [-portcount] 

Availability 

all  users 

Description 

Use  this  command  to  display  switch  and  port  status  information.  Information  might  vary  by  switch  model. 

Switch  summary  information;  it  is  followed  by  a  section  covering  summary  information  by  port: 

switchName  Displays  the  switch  symbolic  name. 

switchType  Displays  the  switch  model  number. 

switchState  Displays  the  switch  state:  online,  offline,  testing,  or  faulty. 

switchRole  Displays  the  switch  role:  principal,  subordinate,  or  disabled. 

switchDomain  Displays  the  switch  domain  ID:  0-31  or  1-239. 

switchid  Displays  the  switch  embedded  port  DJD. 

switchWwn  Displays  the  switch  World  Wide  Name. 

switchBeacon  Displays  the  switch  beaconing  state  (on  or  off). 

bladeBeacon  Displays  the  blade  beaconing  state  (on  or  off). 

The  switch  summary  is  followed  by  one  line  per  port: 

Area  Part  of  the  24-bit  port  ID,  which  consists  of  domain,  area  number,  and 

optional  AL_PA. 

Slot  Slot  number;  slots  numbered  from  1  to  4  and  7  to  10. 

Port  Port  number;  ports  are  numbered  from  0  to  15. 

Media  Type  Media  type: 

dash  (-)  no  module  present 

sw  shortwave  laser 

Iw  longwave  laser 

cu  copper 

id  serial  I 

Speed  Speed  of  the  port: 


1/8G  25  Mbit/sec 

1/4G  250  Mbit/sec 

1/2G  500  Mbit/sec 

1 G  1  Gb/ s  fixed  transfer  speed 

2G  2  Gb/s  fixed  transfer  speed 

Nl  1  Gb/s  negotiated  transfer  speed 

N2  2  Gb/s  negotiated  transfer  speed 

4G  4  Gb/s  negotiated  transfer  speed 

AN  Auto  negotiating 

UN  Unknown 
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Port  State 


comment 


Port  state  information 

No_Card  No  interface  card  present. 

No_Module         No  module  (SFP  or  othier)  present. 
Mod_Val  Module  validation  in  process. Mod_lnv  -  nvalid  module. 

No_Light  Module  not  receiving  light. 

No_Sync  Module  receiving  light  but  out  of  sync. 

ln_Sync  Module  receiving  light  and  in  sync. 

Laser_Flt  Module  signaling  a  laser  fault. 

Port_Flt  Port  marked  faulty. 

Diag_Flt  Port  failed  diagnostics. 

Lock_Ref  Locking  to  the  reference  signal. 

Testing  Running  diagnostics. 

Online  Port  is  up  and  running. 

The  comment  field  is  blank,  or  displays: 
Disabled  Port  is  disabled. 

Port  is  bypassed  (loop  only). 
Port  is  in  loopback  mode. 


Bypassed 
Loopback 
E  Port 


F_Port 

G_Port 

L_Port 

(Trunk  master) 

(upstream) 
(dov/nstream) 


Fabric  port;  displays  WWN  and  name  of  attached 
switch. 

Point-to-point  port;  displays  WWN  of  attached  N_Port. 

Point-to-point  but  not  yet  E_Port  or  F_Port. 

Loop  port;  displays  number  of  NL_Ports. 

Port  is  the  master  port  in  a  group  of  trunking  ports. 
(Trunk  port,  master  is  port  #x)  -  Port  is  configured  as  a 
trunking  port;  the  master  port  is  port  number  x. 

E_Port  is  an  upstream  path  towards  the  principal  switch 
of  the  fabric. 

E_Port  is  a  downstream  path  away  from  the  principal 
switch  of  the  fabric. 


Persistently  Disabled 

This  port  has  been  disabled  using 

portCf gPer sis tentDi sable. 
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Operand 

The  operand  is  as  follows: 
-portcount  Displays  the  number  of  ports  on  the  switch. 

Examples 

To  display  the  port  count: 

switch : admin>  switchShow  -portcount 
ports=  64 


To  display  the  port  status  for  an  E_Port: 


switch:user> 

switchshow 

switchName 

sanll6 

switchType 

10. 

1 

switchState : 

Online 

switchRole 

Subordinate 

s wi  tchDomain : 

2 

switchid: 

f f fc02 

switchWwn: 

10: 

00 : 00 : 60 : 69 

00:02 :48 

switchBeacon : 

OFF 

bladel : 

Beacon: 

OFF 

blade4 : 

Beacon: 

OFF 

Area 

Slot 

Port  Media 

Speed 

State 

0 

10 : 00 : 00  :  60  : 

69  : 

1 
00  : 

02 

IC 

0  id 
sanl3  0 " 

N2 

Online 

E- 

Port 

1 

10 : 00 : 00 : 60 : 

69  : 

1 
00  : 

02 

IC 

1  id 
sanl3  0 " 

N2 

Online 

E- 

Port 

2 

10 : 00 : 00 : 60 : 

69  : 

1 
00  : 

02 

IC 

2  id 
sanl3  0 " 

N2 

Online 

E- 

Port 

3 

10 : 00 : 00 : 60 : 

69  : 

1 
00: 

02 

IC 

3  id 
sanl3  0 " 

N2 

Online 

E- 

Port 

4 

10 : 00 : 00:60 : 

69  : 

1 
00  : 

02 

IC 

4  id 
sanl3  0 " 

N2 

Online 

E- 

Port 

5 

10 : 00 : 00 : 60 : 

69  : 

1 
00  : 

02 

IC 

5  id 
sanl3  0 " 

N2 

Online 

E- 

Port 

6 

10 : 00 : 00:60 : 

69  : 

1 
00  : 

02 

IC 

6  id 
sanl3  0 " 

N2 

Online 

E- 

Port 

7 

10 : 00 : 00 : 60 : 

69  : 

1 
00  : 

02 

IC 

7  id 
sanl3  0 " 

N2 

Online 

E- 

Port 

(output  truncat 

ed) 

See  also 

portCfgLongDi stance 
switchDi sable 
switchEnable 
switchName 
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switchShutdown 

Halts  the  operational  switch. 

Synopsis 

switchshutdown 

Availability 

admin 

Description 

Use  this  command  to  halt  switch  operation  on  one  switch  without  disrupting  the  other.  This  command 
disables  a  logical  switch  in  a  dual-switch  chassis. 

This  command  has  to  be  used  in  combination  with  switchStart. 

This  command  halts  all  the  daemons  associated  with  the  switch,  frees  the  resources  and  object  states 
associated  with  the  switch  to  a  clear  state,  and  disables  all  the  ports  and  blades  associated  with  the 
switch. 


["2^2^  NOTE:    This  command  is  not  supported  on  single-domain  systems. 


Operands 

none 

Examples 

To  halt  the  operational  switch: 


switch : admin>  switchshutdown 

Stopping  all  switch  daemons  ...  Done . 

Powering  off  slot  l...Done. 

Powering  off  slot  4... Done. 

Checking  all  slots  are  powered  off. 

. Done . 

Cleaning  up  kernel  modules  ...  Done . 

See  also 

switchReboot 
switchStart 
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switchStart 


Initializes  a  previously  shut  down  switch. 


Synopsis 

switchstart 

Availability 

admin 

Description 

Use  this  command  to  initialize  one  switch  without  disrupting  the  other  switch  in  the  dual-switch  chassis. 
This  command  has  to  be  used  in  combination  with  switchShutdown. 

This  command  starts  all  the  daemons  associated  with  the  switch,  initializes  the  object  states  associated 
with  the  switch  to  a  clear  state,  and  enables  all  the  ports  and  blades  associated  with  the  switch. 

r2^^  NOTE:   This  command  is  not  supported  on  single-domain  systems. 


To  initialize  the  current  switch: 

switch : ad[nin>  switchstart 
Initializing  kernel  modules  ...  Done . 
Starting  all  switch  daemons  ...  Done . 
Powering  on  slot  l...Done. 
Powering  on  slot  4... Done. 
Checking  diagnostics  ...  Done . 

setup  FCIP  IP:   ifconfig  fcO  ip=0. 0.0.0,   netmask=255 . 255 . 255 . 0 


Operands 


none 


Examples 


See  also 


switchReboot 


switchShutdown 
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switchStatusPolicySet 

Sets  the  policy  parameters  that  determine  overall  switch  status. 

Synopsis 

switchstatuspolicyset 

Availability 

admin 

Description 

Use  this  command  to  set  policy  parameters  for  calculating  the  overall  status  of  the  sv/itch  enclosure.  The 
policy  parameter  values  determine  hov/  many  failed  or  faulty  units  of  each  contributor  are  allov/ed  before 
triggering  a  status  change  in  the  sv/itch  from  HEALTHY  to  MARGINAL  or  DOWN.  The  status  of  the  sv/itch 
can  be  found  by  issuing  the  switchStatusShow  command. 

The  command  displays  the  current  parameters  in  a  three-column  table  format,  shov/n  in  Table  19.  The 
command  then  prompts  the  user  to  change  the  values  for  each  policy  parameter.  The  default  values  for 
the  policy  parameters  are  in  shown  Table  1  9. 

Table  19    Default  contributor,  values,  and  status 


Contributor 

DOWN  default 

MARGINAL  default 

PowerSupplies 

2 

Temperatures 

2 

Fans 

2 

WWN 

0 

CP 

0 

Blade 

0 

Flash 

0 

Marginal  Ports 

2 

Faulty  Ports 

2 

MissingSFPs 

0 

0 

Any  single  contributor  can  force  the  overall  status  of  the  switch  to  MARGINAL  or  DOWN.  For  example, 
assuming  that  the  switch  contributor  values  are  set  to  the  default  values,  if  there  is  one  faulty  port  in  a 
switch,  then  this  contributor  would  set  the  overall  switch  status  to  MARGINAL.  If  two  ports  were  faulty,  then 
this  contributor  would  set  the  overall  switch  status  to  DOWN. 

Operands 

none 
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Examples 

To  change  the  switch  policies: 


switch: adinin>  switchstatuspolicyset 

To  change  the  overall  switch  status  policy  parameters 
The  current  overall  switch  status  policy  parameters: 

Down  Marginal 


Power Supplies 

2 

1 

Temperatures 

2 

1 

Fans 

2 

1 

mm 

0 

1 

CP 

0 

1 

Blade 

0 

1 

Flash 

0 

1 

Marginal Ports 

2 

1 

FaultyPorts 

2 

1 

MissingSFPs 

0 

0 

Note  that  the  value,   0,   for  a  parameter,  means  that  it  is 
NOT  used  in  the  calculation. 

**  In  addition,    if  the  range  of  settable  values  in  the 
**  prompt  is    {0..0),    the  policy  parameter  is  NOT  applicable 
**  to  the  switch.   Simply  hit  the  Return  key. 
Out  of  range  Flash  contributing  to 

MARGINAL  Status:    (0..1)  [1] 

MarginalPorts  contributing  to 

DOWN  status:    {0..64)  [2] 

MarginalPorts  contributing  to 

MARGINAL  Status:    {0..64)  [1] 

(output  truncated) 
(continued  on  next  page) 
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The  minimum  number  of 

Bad  PowerSupplies  contributing  to 

DOWN  status:  (0. 

A  \ 

L  ^  J 

Bad  PowerSupplies  contributing  to 

MARGINAL  Status: 

{ n 

r  1  1 

Bad  Temperatures  contributing 

to 

DOWN  Status :     (0 . 

-  o ; 

r  9  1 

Bad  Temperatures  contributing 

to 

MARGINAL  Status: 

/  n 

.  .  O  ) 

L  -L  J 

Bad  Fans  contributing  to 

DOWN  Status:  (0. 

r  9  1 

Bad  Fans  contributing  to 

MARGINAL  Status: 

1  n 

r  1  1 

Down    WWN  contributing  to 

DOWN  Status :     (0 . 

-  ^  ) 

r  n  T 
L  u  J 

Down    WWN  contributing  to 

MARGINAL  Status: 

( n 

9  ^ 

r  1  1 

Down  CP  contributing  to 

DOWN  Status :    (0 . 

r  n  1 

Down  CP  contributing  to 

MARGINAL  Status: 

I  n 

9  \ 

L  -L  J 

Down  Blade  contributing  to 

DOWN  Status:  (0. 

r  n  1 

Down  Blade  contributing  to 

MARGINAL  Status: 

(0 

.  .4) 

[1] 

Out  of  range  Flash  contributing  to 

DOWN  status:    (0.  .1) 

[0] 

e 

See  also 

switchStatusPolicyShow 
switchStatusShow 
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switchStatusPolicyShow 

Displays  the  policy  parameters  that  determine  overall  switch  status. 

Synopsis 

swi  t chs  ta tuspo 1 i  cyshow 

Availability 

all  users 

Description 

Use  this  command  to  view  the  current  policy  parameters  set  for  the  switch.  These  policy  parameters 
determine  the  number  of  failed  or  nonoperational  units  allowed  for  each  contributor  before  triggering  a 
status  change  in  the  switch. 

The  command  displays  the  current  parameters  in  a  three-column  table  format,  shown  in  Table  20.  The 
default  values  for  the  policy  parameters  are  in  shown  in  Table  20. 

Table  20    Default  contributor,  values,  and  status 


Contributor 

DOWN  default 

MARGINAL  default 

PowerSupplies 

2 

Temperatures 

2 

Fans 

2 

WWN 

0 

CP 

0 

Blade 

0 

Flash 

0 

Marginal  Ports 

2 

Faulty  Ports 

2 

MissingSFPs 

0 

0 

The  policy  parameters  determine  the  number  of  failed  or  nonoperational  units  for  each  contributor  that 
trigger  a  status  change  in  the  switch.  For  example,  if  the  FaultyPorts  DOWN  parameter  is  set  to  3,  and 
three  ports  fail  in  the  switch,  then  the  status  of  the  switch  changes  to  DOWN. 

Operands 

none 
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Examples 

To  display  the  switch  policies: 


switch: admin>  switchstatuspol 

icyshow 

The  current  overall  switch 

status  policy  parameters: 

Down 

Marginal 

Power Supplies 

2 

1 

Temperatures 

2 

1 

Fans 

2 

1 

WWN 

0 

1 

CP 

0 

1 

Blade 

0 

1 

Flash 

0 

1 

Marginal Ports 

2 

1 

FaultyPorts 

2 

1 

MissingSFPs 

0 

0 

See  also 

switchStatusPolicySet 
switchStatusShow 
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switchStatusShow 

Displays  overall  switch  status. 

Synopsis 

switchstatusshow 


Availability 

all  users 

Description 

Use  this  command  to  display  the  overall  status  of  the  sv/itch.  In  addition,  users  with  a  Fabric  Watch  license 
are  able  to  view  the  list  of  unhealthy  ports. 

This  command  displays  the  overall  switch  status,  along  with  the  status  of  each  of  the  following  contributors: 

•  Power  supplies 

•  Temperatures 

•  Fans 

•  WWN  servers  (dual  CP  systems  only) 

•  Standby  CP  (dual  CP  systems  only  with  HA  enabled) 

•  Blades  (bladed  systems  only) 

•  Flash 

•  Marginal  ports 

•  Faulty  ports 

•  Missing  SFPs 

Status  values  are  HEALTHY,  MARGINAL,  or  DOWN,  depending  on  whether  thresholds  established  by 
switchStatusPolicySet  have  been  exceeded.  The  overall  status  is  based  on  the  most  severe  status  of 
all  contributors. 

Refer  to  switchStatusPolicyShow  for  details  on  the  calculation  of  contributors  and  overall  switch 
status. 

Operands 

none 
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Examples 

To  display  a  switch  health  report: 


switch :user>  switchstatusshow 

Switch  Health  Report 
10:48:31  AM 

Report  time:  06/19/2003 

Switch  Name:  switch 

IP  address:  10.10.: 

255.255 

SwitchState:  MARGINAL 

Duration:  00:05 

±rtJWtd-L     t3  Uipp -L -L  *d  O     iLL(_Jli-L  UUJ- 

niijr\Lj  ±  n  X 

Temperatures  monitor 

HEALTHY 

Fans  monitor 

MARGINAL 

WWN  servers  monitor 

HEALTHY 

Standby  CP  monitor 

HEALTHY 

Blades  monitor 

HEALTHY 

Flash  monitor 

HEALTHY 

Marginal  ports  monitor 

HEALTHY 

Faulty  ports  monitor 

HEALTHY 

Missing  SFPs  monitor 

HEALTHY 

All  ports  are  healthy 

See  also 

switchStatusPolicySet 
switchStatusPolicyShow 
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switch  Uptime 

Displays  the  amount  of  time  the  switch  has  been  operating. 

Synopsis 

switchuptime 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  time  and  the  amount  of  time  that  the  switch  has  been  operational. 

Operands 

none 

Examples 

To  view  the  uptime  for  the  switch: 

switch :user>  switchuptime 
9:50pm       up  for  2  0  mins 

See  also 

switchReboot 

switchShutdown 

switchStart 
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syslogdFacility 

Changes  the  syslog  facility. 

Synopsis 

syslogdFacility   [-1  level] 

Availability 

admin 

Description 

Use  this  command  to  change  the  syslog  facility  to  LOG_LOCAL0,  LOG_LOCALl,  LOG_LOCAL2, 
LOG_LOCAL3,  LOG_LOCAL4,  LOG_LOCAL5,  LOG_LOCAL6,  or  LOG_LOCAL7. 

Syslog  daemon  (syslogd)  is  a  process  available  on  most  UNIX  systems  that  reads  and  forwards  system 
messages  to  the  appropriate  log  files  or  users,  depending  on  the  system  configuration. 

The  specified  facility  is  used  when  forwarding  messages  to  the  servers  added  through  the  command 
syslogdipAdd.  The  default  facility  is  LOG_LOCAL7. 

Operands 

This  command  has  following  operand: 

-1  level       Specifies  the  syslog  facility.  The  range  is  from  0  through  7.  This  operand  is 
optional;  if  omitted,  the  current  facility  is  displayed. 

Examples 

To  set  the  syslog  facility  to  LOG_LOCALl : 

switch : admin>  syslogdFacility  -1  1 
Syslog  facility  changed  to  L0G_L0CAL1 

See  also 

syslogdipAdd 
sys 1 ogdIpRemove 
syslogdIpShow 


672   Fabric  OS  commands 


syslogdIpAdd 

Adds  the  IP  address  of  a  syslog  daemon. 

Synopsis 

syslogdipadd  ip_address 

Availability 

admin 

Description 

Use  this  command  to  add  the  IP  address  of  the  server  that  is  running  the  syslogd  process.  Syslog  daemon 
(syslogd)  is  a  process  available  on  most  UNIX  systems  that  reads  and  forv/ards  system  messages  to  the 
appropriate  log  files  or  users,  depending  on  the  system  configuration. 

When  one  or  more  IP  addresses  are  configured,  the  sv^itch  forwards  all  error  log  entries  to  the  syslogd  on 
the  specified  server(s).  Up  to  six  servers  are  supported. 

Operands 

This  command  has  the  following  required  operand: 
ip_address  Specify  the  IP  address  of  the  server  running  syslogd. 

Examples 

To  add  the  address  1 92. 1 68. 1 .60  to  the  list  of  machines  to  which  system  messages  are  sent: 

switch:admin>  syslogdipadd  192.168.1.60 

See  also 

errShow 

sys 1 ogdIpRemove 
syslogdIpShow 
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syslogdIpRemove 


Removes  the  IP  address  of  a  syslog  daemon. 

Synopsis 

syslogdipremove  ip_address 

Availability 

admin 

Description 

Use  this  command  to  remove  the  IP  address  of  the  server  that  is  running  the  syslogd  process. 

Operands 

This  command  has  the  follov/ing  operand: 

ip_address  Specify  the  IP  address  of  the  server  running  syslogd.  This  operand  is  required. 

Examples 

To  remove  the  address  192.168.1 .60  from  the  list  of  machines  to  which  system  messages  are  sent: 

switch: admin>  syslogdipremove  192.168.1.60 

See  also 

errShow 

sys 1 ogdIpAdd 

syslogdIpShow 
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syslogdIpShow 

Displays  all  syslog  daemon  IP  addresses. 

Synopsis 

syslogdipshow 

Availability 

all  users 

Description 

Use  this  command  to  display  all  syslog  daemon  IP  addresses  in  the  configuration  database. 

Operands 

none 

Examples 

To  display  all  syslog  daemon  IP  addresses: 


switch 

adinin>  syslogdipshow 

syslog 

IP . address . 1 : 

192 

168 

.  1 

60 

syslog 

IP . address . 2 : 

192 

168 

.  1 

88 

syslog 

IP . address . 3 : 

192 

168 

.  2 

77 

See  also 

errShow 

sys 1 ogdIpAdd 
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systemVerification 


Runs  a  suite  of  diagnostic  tests  on  all  switches  in  a  fabric. 


Synopsis 

systemverif ication   [-parameters    |    -short]    [ [-fru  type]    -unit  id] 


Use  this  command  to  run  a  comprehensive,  system-wide  test  of  all  switches  in  a  system.  The  command 
initiates  a  burn-in  run  on  all  switches  within  the  current  system.  The  optional  -fru  and  -unit  parameters 
allow  you  to  focus  the  testing  to  a  single  blade  in  a  multiblade  system. 

The  run  can  be  terminated  by  pressing  Ctrl-C  from  the  initiating  terminal.  All  of  the  burn-in  features  are 
operational  during  the  systemVerification  command.  The  burninErrShow  displays  the  stored 
burn-in  errlogs;  the  logs  by  blade  are  saved  in  /var/log/switchburnin.  switch,  slot  files.  On 
fixed-port-count  products,  the  slot  defaults  to  0. 

The  command  monitors  the  testing  and  terminates  the  burn-in  activity  if  all  the  elements  fail.  Each  failing 
slot  only  outputs  the  first  observed  failure.  Because  this  monitoring  is  a  polling  activity,  the  command 
number  output  might  not  be  the  exact  command  number  that  failed. 

After  the  testing  terminates,  the  burninStatus  command  output  displays,  and  the  burninErrShow 
messages  for  the  failing  slots  displays.  If  all  slots  pass,  then  only  the  burninStatus  command  output 
displays. 

The  burn-in  tests  are  designed  to  operate  with  switches  connected  to  a  fabric  and  restrict  the  frame 
loopback  to  inside  the  unit.  If  loopback  plugs  are  installed  in  all  ports,  the  burn-in  parameter  min_lb_mode 
can  be  changed  to  1  to  test  the  Fibre  Channel  through  the  loopback  plug. 


Availability 


admin 


Description 


Operands 


This  command  has  the  following  operands: 


-fru  type 


-short 


-parameters 


Invokes  the  diagSetCycle  command  before  starting  the 
burn-in  run.  This  allows  users  to  modify  the  burn-in  parameters 
prior  to  the  run.  These  diagSetCycle  parameters  are  copied 
to  all  switches  in  the  system  and  override  the  original  settings  in 
the  database.  If  the  diagSetCycle  parameters  are  not 
specified,  the  run  uses  the  previously  stored  values.  This  option 
does  not  perform  a  burninErrClear  operation  prior  to 
starting  the  testing  operation. 

Sets  the  burn-in  parameters  that  control  the  number  of  frames 
to  1 .  The  primary  use  for  this  command  is  software  regression 
testing,  or  quick  validation  that  all  hardware  is  operational.  The 
shorter  test  cycle  does  not  have  enough  test  time  to  detect 
intermittent  errors.  This  option  performs  a  burninErrClear 
operation  prior  to  starting  the  testing  operation. 

Use  to  focus  testing  on  a  single  FRU  in  the  system.  The  valid 
options  for  type  are  BLADE,  PS,  FAN,  and  WWN;  however,  only 
BLADE  is  supported  at  this  time.  Since  only  one  FRU  type  is 
supported,  this  parameter  is  optional,  but  -unit  is  required  for 
single  FRU  testing. 
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-unit  id 


Use  to  focus  testing  on  a  single  FRU  in  the  system.  The  id  for  a 
FRU  type  of  BLADE  correlates  to  the  slot  number  of  the  FRU  to  be 
tested. 


Diagnostics 

Each  diagnostic  test  in  this  suit  might  report  its  own  set  of  error  messages  when  it  detects  failure(s).  Refer  to 
the  Diagnostics  section  of  individual  diagnostic  test  help  pages.  These  messages  are  available  only  in  the 
log  file. 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

Examples 

To  initiate  a  system  verification  test  on  all  switches  in  the  fabric: 

switch : admin>  systemverif ication  -short 

systemverif ication :   Setting  parameters  for  short  run. 
systemverif ication :  burnin  parameters. 
CURRENT   -   KEYWORD  :  DEFAULT 


1  -  number_of _runs  :  1 

2  -  vib       :  2 

10  -  thermal  :  10 

SYSTEMVERIFICATION  -  label    :  BURNIN 

2  -  min_lb_mode  :  2 

1  -  tbr_passes  :  1 

1  -  prt_on  :  1 

1  -  cntmem_on  :  1 

1  -  cmi_on  :  1 

1  -  retention_on  :  1 

1  -  cam_on  :  1 

1  -  flt_passes  :  50 

1  -  sta_passes  :  25 

1  -  plb_nframes  :  100 

1  -  txd_nframes  :  50 

1  -  xpt_nframes  :  2  00 

1  -  bpt_nframes  :  2  0 

1  -  slk_nmegs  :  50 

1  -  bpt_all_nf rames  :   3  0 

1  -  slk_all_nmegs  :  50 


systemverif ication :  Arming  the  burnin  run  on  switch  0. 
systemverif ication :   Starting  burnin  on  Switch  0 

systemverif ication :  Monitoring  progress  of  the  burnin  activity, 
systemverif ication:  Outputting  Status 

State  Status     Run  Cmd  TotCmds  Script 

COMPLETED  PASS         1  22  22  switchburnin . sh 
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See  also 

burninErrClear 
burninStatus 
diagSetBurnin 
diagSetCycle 
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tempShow 

Displays  temperature  readings. 

Synopsis 

temp show 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  temperature  readings  of  all  temperature  sensors  in  a  switch.  For 
each  sensor,  this  command  displays  the  slot  number  (if  applicable),  the  sensor  state,  and  the  temperature. 
The  temperature  readings  are  given  in  both  Centigrade  and  Fahrenheit. 

Refer  to  the  hardware  reference  manual  for  your  switch  to  determine  the  normal  temperature  range. 

Operands 

none 

Examples 

To  display  temperature  and  status  sensors: 


switch :user>  tempshow 

Index 

Slot 

State 

Centigrade 

Fahrenheit 

1 

1 

Ok 

41 

105 

2 

2 

Ok 

39 

102 

3 

3 

Absent 

4 

4 

Absent 

5 

5 

Ok 

26 

78 

6 

6 

Ok 

27 

80 

See  also 

f anShow 
psShow 
sensorShow 
slotShow 
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timeout 

Sets  or  displays  the  idle  timeout  value  for  a  login  session. 

Synopsis 

timeout  [timeval] 

Availability 

admin  (set  and  display) 

all  users  (display  only) 
Description 

Use  this  command  with  out  an  operand  to  display,  in  minutes,  the  current  timeout  value  after  which  idle 
logins  are  automatically  terminated. 

Use  this  command  with  the  timeval  operand  to  set  the  login  timeout  value  to  the  specified  interval.  A 
value  of  0  disables  timeout  functionality  of  login  sessions. 

Operands 

This  command  has  the  following  operand: 

timeval  Specify  the  number  of  minutes  for  the  Telnet  timeout  value.  Valid  values  are  1  to 

99,999,  or  0  to  disable  login  timeouts.  This  operand  is  optional;  if  omitted,  the 
command  displays  the  current  timeout  value. 

Examples 

To  set  the  idle  timeout  to  10  minutes: 

switch : admin>  timeout  10 

IDLE  Timeout  Changed  to  10  minutes 

The  modified  IDLE  Timeout  will  be  in  effect  after  NEXT  login 


680   Fabric  OS  commands 


topologyShow 


Displays  the  unicast  fabric  topology. 


Synopsis 


topologyshow  [domain] 


Availability 

all  users 


Description 

Use  this  command  to  display  the  fabric  topology,  as  it  appears  to  the  local  switch,  including: 

•  A  list  of  all  domains  that  are  part  of  the  fabric,  and  to  each  of  those  domains,  all  possible  paths  from 
the  local  switch. 

•  For  each  path  cost,  the  number  of  hops  from  the  local  switch  to  the  destination  switch  and  a  summary 
of  all  ports  are  routed  through  that  path. 


The  display  contains  the  following  fields: 

Local  Domain  ID 
Domain 
Metric 
Name 


Path  Count 
Hops 
Out  Port 

In  Ports 

Total  Bandwidth 
Bandwidth  Demand 
Flags 


Domain  number  of  local  switch. 

Domain  number  of  destination  switch. 

Cost  of  reaching  destination  domain. 

The  name  of  the  destination  switch. 

The  number  of  currently  active  paths  to  the  destination  domain. 

The  maximum  number  of  hops  to  reach  destination  domain. 

Port  to  which  incoming  frame  are  forwarded  to  reach  the 
destination  domain. 

Input  ports  that  use  the  corresponding  out  port  to  reach  the 
destination  domain.  This  is  the  same  information  provided  by 

portRouteShow  and  urouteShow. 

The  maximum  bandwidth  of  the  out  port. 

The  maximum  bandwidth  demand  by  the  in  ports. 

Always  D,  indicating  a  dynamic  path.  A  dynamic  path  is 
discovered  automatically  by  the  FSPF  path  selection  protocol. 


Operands 


This  command  has  the  following  operand: 

domain 


Specify  the  destination  domain  for  which  topology  information  is 
to  be  displayed.  This  operand  is  optional;  if  omitted,  this 
command  displays  the  topology  information  of  all  the  domains 
in  the  fabric. 
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Examples 

To  display  the  unicast  fabric  topology: 


switch : admin>  topologyshow 

 1 

2  domains  in  the  fabric;  Local 

Domain  ID:  1 

Domain:  6 

Metric:  500 

Name :  switch 

Path  Count:  4 

Hops  : 

1 

Out  Port: 

60 

In  Ports: 

None 

Total  Bandwidth: 

2  Gbps 

Bandwidth  Demand: 

0  % 

Flags : 

D 

Hops  : 

1 

Out  Port: 

61 

In  Ports: 

None 

Total  Bandwidth: 

2  Gbps 

Bandwidth  Demand: 

0  % 

Flags : 

D 

Hops  : 

1 

Out  Port: 

62 

In  Ports : 

None 

Total  Bandwidth: 

2  Gbps 

Bandwidth  Demand: 

0  % 

Flags : 

D 

Hops  : 

1 

Out  Port: 

58 

In  Ports : 

None 

Total  Bandwidth: 

2  Gbps 

Bandwidth  Demand: 

0  % 

Flags : 

D 

See  also 

portRouteShow 
urouteShow 
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traceDump 

Displays,  initiates,  or  removes  a  trace  dump. 

Synopsis 

tracedump   [-S]    [-s  slot] 
tracedump  -n   [-s  slot] 
tracedump  -r   [-s  slot] 

Availability 

admin 

Description 

Use  this  command  to  initiate  a  background  trace  dump,  remove  a  trace  dump,  or  display  the  trace  dump 
status  on  the  switch. 

I^if  NOTE:    If  there  is  no  parameter  specified,  this  command  defaults  to  traceDump  -S. 


Operands 

This  command  has  the  follov/ing  mutually  exclusive  operands: 

-S  Displays  dump  status. 

-n  Initiates  a  background  trace  dump. 

-r  Removes  a  trace  dump. 

This  command  has  the  follov/ing  optional  operand: 

--S  slot  Specifies  the  slot  number  from  which  a  trace  dump  is  generated.  If  this  is 

not  supplied,  the  trace  dump  is  generated  from  the  local  slot. 

Examples 

To  initiate  a  background  trace  dump  from  slot  5: 

switch : admin>  tracedump  -n  -s  5 

To  remove  a  trace  dump: 

switch :  adinin>  tracedump  -r 
trace  dump  removed 

See  also 

supportFtp 

supportSave 

supportShow 

traceFtp 

traceTrig 
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traceFtp 

Displays,  enables,  or  disables  the  trace  auto-FTP,  or  retrieves  the  trace  dump  file. 

Synopsis 

traceftp  [-S] 
traceftp  -e 
traceftp  -d 

traceftp  -n   [-s  slot]    [-h  hostip]    [-u  username]    [-p  password] 
[-d  remotedirectory]    [-f  remotefile] 

Availability 

admin 

Description 

Use  this  command  to  display,  enable,  or  disable  trace  auto-FTP  or  to  retrieve  a  trace  dump  file  from  the 
switch  to  the  FTP  site  immediately. 

r2^^  NOTE:    If  there  is  no  parameter  specified,  this  command  defaults  to  traceftp  -S. 

Default  remote  file  name  format  for  traceftp  -n  is  switchname-S^-YYYYMMDDHHMMSS.dmp.  The  # 
is  the  slot  number  (0  if  it  is  on  nonbladed  system),  and  YYYYMMDDHHMMSS  is  trace  dump  time 
(year-month-day-hour-minute-second). 


Operands 

This  command  has  the  follov/ing  mutually  exclusive  operands: 

-S  Displays  trace  auto-FTP  feature, 

-e  Enables  trace  auto-FTP  feature, 

-d  Disables  trace  auto-FTP  feature. 

-n  Retrieves  a  trace  dump  file  from  the  switch  immediately.  The  -n  option  has  the  following 

optional  operands: 

-s  slot  Specifies  the  slot  number  from  which  a  trace  dump  is 

generated.  If  this  is  not  supplied,  the  trace  dump  is  generated 
from  the  local  slot. 

-h  hostip  Specifies  FTP  host  IP  address.  It  must  be  IP  address, 

-u  userriame  Specifies  FTP  user  name. 

-p  password  Specifies  FTP  user  password.  If  the  user  name  is  anonymous, 

the  password  is  not  needed. 

-d  remotedirectory      Specifies  the  remote  directory  which  to  store  a  trace  dump  file. 

Specifies  the  remote  file  which  to  store  a  trace  dump  file. 

-f  remotefile 
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Examples 

To  retrieve  a  trace  dump  file: 

switch : ad[nin>  traceftp  -n  -h  192.158.67.126  -u  anonymous  -d  tracedump  -f 
dumpf ile 

ftp  trace  dump  file  in  progress... 
ftp  trace  dump  file  succeeded 

To  enable  the  auto-FTP  feature: 

switch : admin>  traceftp  -e 
trace  auto-FTP  enabled 

To  disable  the  auto-FTP  feature: 

switch : admin>  traceftp  -d 
trace  auto-FTP  disabled 

See  also 

supportFtp 

supportSave 

supportShow 

traceDump 

traceTrig 
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traceTrig 

Sets,  removes,  or  displays  trace  triggers. 

Synopsis 

tracetrig   [-S]    [-s  slot] 
tracetrig  -a   [-s  slot]  msgid 
tracetrig  -r    [-s  slot]  msgid 
tracetrig  -R   [-s  slot] 

Availability 

admin 

Description 

Use  this  command  to  set,  remove,  or  display  trace  triggers  for  the  specified  slot  on  the  switch. 
'2^^  NOTE:    If  there  is  no  parameter  specified,  this  command  defaults  to  tracetrig  -S. 


Operands 

This  command  has  the  following  mutually  exclusive  operands: 

-S  Displays  trace  triggers  for  the  specified  slot, 

-a  Sets  a  trace  trigger  for  the  specified  slot, 

-r  Removes  a  trace  trigger  from  the  specified  slot. 

-R  Removes  all  trace  triggers  from  the  specified  slot. 

■This  command  has  the  following  optional  operand: 

-s  slot  Specifies  the  slot  number  from  which  a  trace  dump  is  generated.  If  this 

is  not  supplied,  the  trace  dump  is  generated  from  the  local  slot. 

The  -a  and  -r  options  also  have  the  following  required  operand: 

msgid  Specifies  the  trigger  number,  using  the  RASLog  message  ID.  This 

operand  is  required. 

Examples 

To  set  a  trace  trigger: 

switch : admin>  tracetrig  -a  NS-lOOl 
trace  trigger [NS-lOOl ]    is  added 

To  remove  a  trace  trigger: 

switch : admin>  tracetrig  -r  NS-lOOl 
trace  trigger [NS-lOOl ]    is  removed 
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To  remove  all  trace  triggers: 


switch :  adinin>  tracetrig  -R 
all  trace  triggers  are  removed 

See  also 

supportFtp 

supportSave 

supportShow 

traceFtp 

traceFtp 
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trackChangesHelp 

Displays  information  on  track-changes  feature  commands. 

Synopsis 

trackchangeshelp 

Availability 

all  users 

Description 

Use  this  command  to  display  information  about  the  track-changes  commands. 

Examples 

To  display  information  on  the  track-changes  feature  commands: 

switch : admin>  trackchangeshelp 

trackChangesSet  Configure  alert  for  login/logout/conf ig  update 
trackChangesShow      Displays  status  of  track  changes 

See  also 

trackChangesSet 
trackChangesShow 
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trackChangesSet 

Enables  or  disables  configuring  of  track-changes  feature. 

Synopsis 

trackchangesset   [mode]  [ ,  snmptrapmode] 

Availability 

admin 

Description 

Thiis  command  enables  or  disables  the  track-changes  feature.  An  SNMP-TRAP  mode  can  also  be  enabled. 
Trackable  changes  are: 

•  Successful  login 

•  Unsuccessful  login 

•  Logout 

•  Config  file  change  from  task 

•  Track  changes  on 

•  Track  changes  off 

The  output  from  the  track-changes  feature  is  dumped  to  the  error  log  for  the  switch.  Use  the  errDump 
command  or  errShow  command  to  view  the  error  log. 

Operands 

This  command  has  the  following  operands: 

mode  Specify  1  to  enable  the  track-changes  feature  or  specify  0  to 

disable  the  feature.  The  default  (if  no  operand  is  specified)  is  to 
disable  the  track-changes  feature.  This  operand  is  optional. 

snmptrapmode  Specify  1  to  enable  errors  to  be  sent  to  the  SNMP-TRAP  in 

addition  to  the  errlog  or  specify  0  to  disable  the  SNMP-TRAP 
messages.  The  default  (if  no  operand  is  specified)  is  to  disable 
SNMP-TRAP  messages.  This  operand  is  optional. 

Examples 

To  enable  the  track-changes  feature: 

switch :  adinin>  trackchangesset  1,  1 
Committing  configuration ...  done . 
switch : admin>  trackchangesshow 
Track  changes  status :  ON 
Track  changes  generate  SNMP-TRAP:  YES 


Fabric  OS  5.0.0  command  reference  guide  689 


See  also 

agtCf gSet 
agtCf gShow 
trackChangesHelp 
trackChangesShow 


690   Fabric  OS  commands 


trackChangesShow 


Displays  status  of  track-changes  feature. 

Synopsis 

trackchangesshow 

Availability 

all  users 

Description 

Use  thiis  command  to  display  status  of  thie  track-changes  feature.  It  displays  if  the  feature  is  turned  on  or  off 
and  if  SNMP  traps  are  generated. 

The  output  from  the  track-changes  feature  is  dumped  to  the  error  log  for  the  switch.  Use  the  errDump 
command  or  errShow  command  to  view  the  error  log. 

Operands 

none 

Examples 

To  display  the  status  of  the  track-changes  feature: 

switch : admin>  trackchangesshow 

Track  changes  status :  ON 

Track  changes  generate  SNMP-TRAP :  YES 

See  also 

trackChangesHelp 
trackChangesSet 
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trunkDebug 

Debugs  a  trunk  link  failure. 

Synopsis 

trunkdebug  portl  port2 

Availability 

admin 

Description 

Use  this  command  to  debug  a  trunk  link  failure.  This  command  reports  one  of  the  following  messages, 
based  on  the  trunking  properties  of  the  two  specified  ports: 

•  Switch  does  not  support  trunking 

•  Trunking  license  required 


• 

port 

port_ 

id 

is  not  E_ 

_Port 

• 

port 

port_ 

id 

trunking 

disabled 

• 

port 

port_ 

id 

speed  is 

not  2G  or  4G 

• 

port 

port_ 

id 

and  port 

port_id  are  not  on  same  quad 

• 

port 

port_ 

id 

and  port 

port_id  connect  to  different 

switches 

• 

port 

port_ 

id 

is  not  a 

trunking  port  due  to:  E_Port 

being  disabled. 

trunking  might  be  disabled  at  remote  port 

•    port  port_id  and  port  port_id  cannot  trunk,   please  check  link  length  to 
make  sure  difference  is  less  than  400m 

Operands 

This  command  has  the  following  operands: 

portl  Specify  the  area  number  of  port  1 .  Use  the  switchShow  command  to  view 

the  area  numbers  for  a  port.  This  operand  is  required. 

port2  Specify  the  area  number  of  port  2.  Use  the  switchShow  command  to  view 

the  area  numbers  for  a  port.  This  operand  is  required. 

Examples 

To  debug  a  trunk  connection: 

switch : admin>  trunkdebug  43  44 
Switch  does  not  support  trunking 

switch : admin>  trunkdebug  62  63 
port  62  and  63  are  trunked  together 
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See  also 

portCf gTrunkPort 
swi  tchC  f gTrunk 
trunkShow 
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trunkShow 

Displays  trunking  information. 

Synopsis 

trunkshow 

Availability 

all  users 

Description 

Use  this  command  to  display  trunking  information.  The  following  fields  display: 

Trunking  Group  Number     Displays  each  trunking  group  on  a  switch.  All  the  ports  that  are  part  of 

this  trunking  group  are  displayed. 

Port  to  port  connections       Displays  the  port-to-port  trunking  connections. 

WWN  Displays  the  WWN  of  the  connected  port. 

deskew  The  time  difference  for  traffic  to  travel  over  each  ISL  compared  to  the  time 

to  the  shortest  ISL  in  the  group.  The  number  corresponds  to  nanoseconds 
divided  by  10.  The  firmware  automatically  sets  the  minimum  deskew 
value  of  the  shortest  ISL  to  1 5. 

Master  Displays  whether  this  trunking  port  connection  is  the  master  port 

connection  for  the  trunking  group. 

Operands 

none 

Examples 

To  display  trunking  information  for  a  switch: 


switch 

: admin> 

trunkshow 

1:  6 

-> 

4 

10 

GO 

00: 

60 

69 

51 

43 

04 

deskew 

15 

MASTER 

2  : 15 

-> 

13 

10 

00 

00  : 

60 

69 

51 

43 

04 

deskew 

16 

MASTER 

12 

-> 

12 

10 

00 

00: 

60 

69 

51 

43 

04 

deskew 

15 

14 

-> 

14 

10 

00 

00: 

60 

69 

51 

43 

04 

deskew 

17 

13 

-> 

15 

10 

00 

00  : 

60 

69 

51 

43 

04 

deskew 

16 

3  :24 

-> 

14 

10 

00 

00: 

60 

69 

51 

42 

dd 

deskew 

15 

MASTER 

See  also 

portCf gTrunkPort 
swi  tchC  f gTrunk 
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tsClockServer 


Displays  or  sets  the  NTP  Server  address. 

Synopsis 

tsclockserver  [ipaddr] 

Availability 

all  users  (display) 

admin  (set) 
Description 

Use  this  command  to  synchronize  the  local  time  of  the  principal  or  primary  PCS  switch  to  an  external  NTP 
server. 

The  time  server  daemon  synchronizes  fabric  time  by  sending  updates  of  the  principal  or  primary  PCS  local 
switch  time  periodically  to  every  switch  in  the  fabric.  The  time  server  daemon  runs  on  all  switches  in  the 
fabric,  but  only  the  principal  switch  (when  the  security  feature  is  not  enabled)  or  the  primary  PCS  switch 
(when  the  security  feature  is  enabled)  connect  to  the  NTP  server  and  broadcast  time  service  updates. 

All  switches  in  the  fabric  maintain  the  current  clock  server  IP  address  in  flash  memory.  By  default,  this  value 
is  LOCL.  Changes  to  the  clock  server  IP  address  on  the  principal  or  primary  PCS  switch  are  propagated  to 
all  switches  in  the  fabric. 

Use  this  command  with  no  parameters  to  display  the  current  clock  server  IP  address  being  used.  Specify 
the  ipaddr  operand  to  set  the  clock  server  IP  address  and  enable  fabric-wide  clock  synchronization  with 
the  specified  clock  server. 

The  NTP  server  used  musf  support  a  full  NTP  client.  Fabric  OS  v3.1 .0  and  v2.6.1  have  an  SNTP  client  and 
hence  will  accept  an  SNTP  or  NTP  server,  but  v4.1 .0  has  an  NTP  client,  so  for  the  proper  functioning  of  a 
mixed  fabric  with  external  time  synchronization  it  is  necessary  that  an  NTP  server  that  supports  a  full  NTP 
client  be  used. 

The  ipaddr  specified  should  be  the  IP  address  of  an  NTP  server  and  should  be  accessible  from  the 
switch.  When  a  clock  server  IP  address  other  than  LOCL  is  specified  but  is  not  used  by  the  fabric,  a 
warning  is  displayed  and  logged.  When  a  clock  server  IP  address  other  than  LOCL  is  specified,  the  date 
command  is  restricted  to  display  only.  Refer  to  the  date  command  for  more  details. 

[2^^  NOTE:    When  secure  mode  is  enabled,  this  command  can  be  run  on  all  switches  to  view  the  NTP  server 
IP  address.  You  can  only  modify  the  NTP  server  IP  address  on  the  primary  PCS  switch. 


Operands 

This  command  has  the  following  operand: 

ipaddr  Specify  the  IP  address  of  the  NTP  server.  This  operand  is 

optional.  By  default,  this  value  is  LOCL. 

If  no  operand  is  specified,  the  current  value  displays. 
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Examples 

To  display  the  current  clock  server  value  (LOCL),  set  the  value  to  an  NTP  server  at  the  specified  IP  address 
and  then  verify  that  the  new  IP  address  v/as  saved: 


switch : admin>  tsclockserver 

LOCL 

switch : admin>  tsclockserver  "123.123 

.  123 . 123 " 

Updating  Clock  Server  configuration. 

. . done . 

switch : admin>  tsclockserver 

123  . 123  . 123 . 123 

See  also 

date 
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tsHelp 


Displays  the  time  service  commands. 

Synopsis 

tshelp 

Availability 

all  users 

Description 

Use  this  command  to  display  a  list  of  time  service  commands. 

Examples 

To  display  a  list  of  time  service  commands: 


switch :  adinin>  tshelp 

tsTimeZone 

Display  or 

set 

the 

system  Time  Zone 

tsClockServer 

Display  or 

set 

the 

NTP  Server  address 

Fabric  OS  5.0.0  command  reference  guide  697 


tsTimeZone 


Displays  or  sets  the  system  time  zone. 


Synopsis 

tstimezone   [houroffset   [,  minuteoffset]] 

Availability 

all  users  (display) 

admin  (set) 
Description 


Use  this  command  to  display  or  set  the  system  time  zone. 

All  switches  maintain  the  current  time  zone  setup  in  flash  memory.  Changing  the  time  zone  on  a  switch 
updates  the  local  time  zone  setup  and  is  reflected  in  local  time  calculations. 

All  switches  are  by  default  in  the  0,0  time  zone:  that  is,  GMT.  If  all  switches  in  a  fabric  are  in  one  time 
zone,  it  is  possible  to  leave  the  time  zone  setup  at  the  default. 

Time  zone  is  used  only  in  computing  local  time,  which  is  used  for  error  reporting  and  logging.  An 
incorrect  time  zone  setup  do  not  affect  the  switch  operation  in  any  way. 

Enter  this  command  with  no  parameters  to  display  the  time  zone  setup.  With  the  valid  parameters,  it  sets 
the  time  zone  for  an  individual  switch. 

Negative  /louroffse/ values  mean  the  local  time  is  behind  GMT;  for  example:  -8,0  is  GMT-08:00 
Positive  houroffset  values  mean  the  local  time  is  ahead  of  GMT;  for  example:  3,  0  is  GMT+03:00 


NOTE:  In  systems  with  multiple  switches  in  a  single  switch  chassis,  time  zone  of  switch  0  is  the  system 
time  zone. 


Operands 


This  command  has  the  following  operands: 


minuteoffset 


houroffset 


Specify  the  number  of  hours  relative  to  GMT.  This  operand  must  be 
specified  as  an  integer.  Valid  values  are  -1 2  through  1 2.  This  operand 
is  optional. 

Specify  the  number  of  minutes  relative  to  houroffset.  This  operand 
must  be  specified  as  an  integer.  Valid  values  are  -30,  0,  or  30.  This 
operand  is  optional. 


698   Fabric  OS  commands 


Examples 

To  display  the  current  time  zone  setup  and  then  change  them  to  GMT-3:30: 


switch : adinin>  tstimezone 

Time  Zone  Hour  Offset:  0 

Time  Zone  Minute  Offset:  0 

switch : adiriin>  tstimezone  -3,    -3  0 

Updating  Time  Zone  configuration.. 

. . done . 

switch : adinin>  tstimezone 

Time  Zone  Hour  Offset:  -3 

Time  Zone  Minute  Offset:  -30 

See  also 

date 
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turboRamTest 


Performs  a  turbo  SRAM  logic  test  for  2  Gb/s  ASICs. 

Synopsis 

turboramtest   [--slot  slotnumber]  [-passcnt  count] [-ports  itemlist] 

Availability 

admin 

Description 

This  command  verifies  the  on  chip  SRAM  located  in  the  2  Gb/s  ASIC  using  the  turbo-RAM  BIST  circuitry. 
These  same  SRAMS  are  tested  by  portRegTest  and  sramRetentionTest  using  PCI  operations  but 
for  this  test,  the  BIST  controller  is  able  to  perform  the  SRAM  write  and  read  operations  at  a  much  faster 
rate.  It  is  also  able  to  test  one  SRAM  in  each  quadrant  of  every  chip,  in  parallel. 

The  test  flov/  for  each  SRAM  is  as  follov/s: 

1.  Fill  RAM  with  alternating  FFFF  0000  pattern.  (Subtest  1 :  turboram  memory  fill) 

2.  For  each  incrementing  address,  read  FFFF  0000  pattern  and  write  0000  FFFF.  (Subtest  2:  turbo-ram 
r-m-w  inc  1 ) 

3.  For  each  incrementing  address,  read  0000  FFFF  pattern  and  write  FFFF  0000.  (Subtest  3:  turbo-ram 
r-m-w  inc  2) 

4.  For  each  decrementing  address,  read  FFFF  0000  pattern  and  write  0000  FFFF.  (Subtest  4:  turbo-ram 
r-m-w  dec  1 ) 

5.  For  each  decrementing  address,  read  0000  FFFF  pattern  and  write  FFFF  0000.  (Subtest  5:  turbo-ram 
r-m-w  dec  2) 

6.  Repeat  Steps  1-5  with  AAAA  5555  pattern. 

Operands 

This  command  has  the  following  operands: 

--slot  slotnumber      Specifies  the  slot  number  on  which  the  diagnostic  operates.  The 

ports  specified  are  relative  to  this  slot  number.  The  default  is  0 
and  designated  to  operate  on  fixed-port-count  products. 

-passcnt  count  Specify  the  number  of  times  to  perform  this  test.  The  default  value 

is  1 .  This  operand  is  optional. 

-ports  i  temlist  Specify  a  list  of  blade  ports  to  test.  By  default,  all  the  blade  ports 

in  the  specified  slot  are  tested.  Refer  to  the  itemList  command 
help  page  for  more  information.  This  operand  is  optional. 

Examples 

To  execute  this  test: 

switch: admin>  turboramtest  -passcnt  2  -ports  2/0-2/63 
Running  Turbo  RAM  Test    passed. 
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Diagnostics 

When  it  detects  failure(s),  the  subtest  might  report  one  or  more  of  the  following  error  messages: 

DIAG-WTEST 
DIAG-INC_RWTEST 
DIAG-DEC_RWTEST 
DIAG-RAMINIT_TO 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide 
more  information. 

See  also 

centralMemoryTest 

cmemRetentionTest 

cmiTest 

portRegTest 

sramRetentionTest 
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txdPath 

Performs  a  functional  test  of  ASIC  pair  TXA,TXD  connections. 

Synopsis 

txdpath   [--slot  slotnumber]  [-nframes  count] [-lb_mode  mode]  [-spd_mode 
mode]  [-nonstop  mode]  [-ports  itemlist] 

Availability 

admin 

Description 

Use  this  command  to  verify  the  TXA,  TXD,  and  CMI  data  paths  between  the  chips  within  a  mini-switch. 
This  is  done  by  configuring  all  of  the  ports  on  the  mini-switch  in  internal  loopback  and  sending  a  frame 
from  each  quadrant  to  each  other  port  on  the  same  mini-switch.  The  frame  starts  from  the  CPU  and  is 
transmitted  by  the  first  port  which  also  receives  the  frame  and  deposits  it  in  central  memory.  The  second 
port  then  reads  the  frame  from  central  memory  using  its  own  TXA, TXD  path.  The  frame  is  then  looped  back 
one  more  time  and  is  sent  back  to  the  CPU,  where  it  is  compared  with  the  transmitted  data. 

Only  one  frame  is  transmitted  and  received  at  any  one  time.  External  cable  is  not  required  to  run  this  test. 
The  port  LEDs  flicker  green  rapidly  while  the  test  is  running.  The  test  method  is  as  follows: 

1.  Set  all  ports  present  for  parallel  loopback.  Then,  for  each  pair  of  source  quadrants  and  destination 
ports: 

2.  Set  up  a  source  port  to  route  frames  to  a  destination  port  and  a  destination  port  to  route  frames  to  the 
CPU. 

3.  Transmit  frame  F  through  the  source  port. 

4.  Pick  up  the  frame  from  the  destination  port. 

5.  Check  if  any  of  the  eight  statistic  error  counters  are  not  0: 

ENC_in,   CRC_err,   TruncFrm,   FrmTooLong,   BadEOF,   Enc_out,   BadOrdSet,  DiscC3 

6.  Repeat  steps  2  through  5  for  all  ports  present  until  either  the  number  of  frames  (or  -nmegs  count) 
requested  is  reached,  or,  all  ports  are  marked  bad. 

At  each  pass,  a  different  data  type  is  used  to  create  the  frame  from  a  palette  of  seven;  meaning  if  a  pass 
of  seven  is  requested,  seven  different  frames  are  used  in  the  test.  If  eight  passes,  the  first  seven  frames  are 
unique,  and  the  eighth  is  the  same  as  the  first.  The  data  palette  of  seven  are: 

1.  CSPAT:  0x7e,  0x7e,  0x7e,  0x7e,  ... 

2.  BYTE_LFSR:  0x69,  0x01,  0x02,  0x05,  ... 

3.  CHALF_SQ:  Ox4a,  Ox4a,  Ox4a,  Ox4a,  ... 

4.  QUAD_NOT:  0x00,  Oxff,  0x00,  Oxff,  ... 

5.  CQTR_SQ:  0x78,  0x78,  0x78,  0x78,  ... 

6.  CRPAT:  Oxbc,  Oxbc,  0x23,  0x47  ... 

7.  RANDOM:  0x25,  0x7f,  0x6e,  0x9a,  ... 

If  seven  passes  are  requested,  the  seven  different  data  types  are  used  in  the  test.  If  eight  passes  are 
requested,  the  first  seven  frames  use  unique  data  type. 
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Operands 


--slot 
slotnumber 

-nmegs  count 
-lb  mode  mode 


This  command  has  the  following  operands:- 

Specifies  the  slot  number  that  the  diagnostic  will  operate  on.  The  ports 
specified  will  be  relative  to  this  slot  number.  The  default  is  set  to  0  and  designed 
to  operate  on  fixed-port-count  products. 

Specifies  the  number  of  frames  to  send  in  millions.  The  test  progresses  until  the 
specified  number  of  frames  transmits  on  each  port.  The  default  value  is  1 0, 
which  represents  10  million  frames. 

Select  the  loopback  point  for  the  test.  By  default,  spinJitter  uses  port 
loopback 

0  Cable  loopback 

1  Port  loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 

3  Silkscreen  loopback 

5  Internal  (parallel)  loopback 

Specifies  the  speed  mode  for  the  test.  This  parameter  is  used  for 
Bloom  and  Condor  ASIC-based  products  only,  for  which  it  controls 
the  speed  at  which  each  port  operates.  For  1  G-only  products,  this 
parameter  is  ignored.  The  exact  operation  of  modes  5  through  8 
depends  on  the  loopback  mode  selected.  When  speed  modes  5 
through  8  are  used  with  cables,  they  must  be  connected 
EVEN->ODD  or  the  test  fails. 

Run  test  at  1  Gb/s,  2  Gb/s,  and  4  Gb/s. 


-spd_mode  mode 


0 

1 

2 
3 


Run  test  at  1  Gb/s. 

Run  test  at  2  Gb/s  (Bloom  default). 

Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  1  Gb/s. 


4  In  test  at  4  Gb/s  (Condor  default).  For  -lb_mode  set  to  0,1 ,  the 

following  speed  modes  are  available  to  test  the  speed  negotiation. 

For  -lb_mode  set  to  0,1,  the  following  speed  modes  are  available  to  test  the 
speed  negotiation. 

3  Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  1  Gb/s. 

4  Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  2  Gb/s. 

5  Set  all  odd  ports'  speed  for  autonegotiate.  Set  all  even  ports'  speed 
for  1  Gb/s. 

6  Set  all  odd  ports'  speed  for  autonegotiate.  Set  all  even  ports'  speed 
for  2  Gb/s. 

For  -lb_mode  set  to  2,3,  the  following  speed  modes  are  available  to  test  FIFO 
underrun. 

3,5 


4,6 


Set  all  even  ports'  speed  for  2  Gb/s.  Set  all  odd  ports'  speed  for 

1  Gb/s. 

Set  all  even  ports'  speed  for  1  Gb/s.  Set  all  odd  ports'  speed  for 

2  Gb/s. 
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--nonstop  mode     Specify  nonstop  mode.  If  set  to  a  nonzero  value,  the  test  does  not  stop  on  the 
first  error.  The  default  value  is  0. 

-ports  Specify  a  list  of  user  ports  to  test.  By  default,  all  of  the  user  ports  in  the  current 

itemlist  switch  are  tested.  This  option  might  be  used  to  restrict  testing  to  the  specified 

ports. 

Examples 

To  run  the  txdPath  test: 

switch : admin>  txdpath 

Running  TX  Data  Path  Test  .... 

Test  Complete:    "txdpath"  Pass  10  of  10 

Duration  0  hr,    0  min  &  47  sec  (0:0:47:645). 

Diagnostics 

When  it  detects  failure(s),  the  test  can  report  one  or  more  of  the  following  error  messages: 

DATA 

ERRSTAT 

INIT 

PORTDIED 
STATS 
TIMEOUT 
XMIT 

Refer  to  the  HP  StorageWorks  Fabric  OS  4.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

backport 
camTest 

centralMemoryTest 

cmemRetentionTest 

cmiTest 

cross PortTest 

itemList 

portLoopbackTest 

portRegTest 

spinSilk 

sramRetentionTest 
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upTime 

Displays  length  of  time  the  system  has  been  operational. 

Synopsis 

uptime 

Availability 

all  users 

Description 

upTime  provides  a  one  line  display  of  the  following  information.  The  current  time,  how  long  the  system 
has  been  running,  how  many  users  are  currently  logged  on,  and  the  system  load  averages  for  the  past  1 , 
5,  and  15  minutes. 

For  up  and  powered-on  times  less  than  60  seconds,  the  time  is  displayed  in  seconds.  For  times  greater 
than  or  equal  to  60  seconds,  the  time  is  displayed  in  minutes.  The  output  format  adjusts  accordingly. 

Operands 

none 

Examples 

To  display  the  length  of  time  the  system  has  been  operational: 

switch :  adinin>  uptime 

12:03ain    up     4:55,     3  users,     load  average:   1.17,    1.08,  1.08 

See  also 

date 

f astBoot 

reboot 
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urouteConfig 


Configures  a  static  route. 

Synopsis 

urouteconfig  InArea  Domain  OutArea 

Availability 

admin 

Description 

Use  thiis  command  to  configure  static  routes.  A  static  route  is  a  route  that  is  assigned  to  a  specific  path 
(defined  by  port  number  OutArea),  a  route  that  does  not  change  when  a  topology  change  occurs  unless 
the  path  used  by  the  route  becomes  unavailable. 

After  this  command  is  issued,  and  if  OutArea  is  associated  with  a  valid  minimum-cost  path,  all  frames 
coming  in  from  InArea  port  addressed  to  Domain  are  forwarded  through  OutArea  port. 

If  OutArea  port  is  not  associated  with  such  a  path,  the  routing  assignment  is  not  immediately  affected  by 
this  command.  When  OutArea  port  becomes  usable  again,  the  static  route  assignment  for  InArea  is 
enforced. 

InArea  port  can  be  either  an  F  Port  or  an  E_Port. 


NOTE:    When  using  static  routes,  load  sharing  might  be  affected.  The  switch  attempts  to  achieve  optimum 
load  sharing,  but  if  too  many  routes  are  statically  configured  to  use  the  same  output  port,  a  fair  load 
sharing  might  not  be  achievable. 

To  prevent  routing  loops,  static  route  configuration  using  a  non-minimum-cost  path  is  not  allowed.  If  a  you 
configure  such  a  route,  you  are  queried  as  to  whether  or  not  the  entry  should  be  saved  in  the  database. 


Operands 

This  command  has  the  following  operands: 

InArea  Specify  the  port  to  be  statically  routed. 

Domain  Specify  the  destination  domain. 

OutArea  Specify  the  output  port  to  which  traffic  is  forwarded. 
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Examples 

To  configure  a  static  route  for  all  traffic  coming  in  from  port  1  and  addressed  to  domain  2  to  go  through 
port  5 : 

switch : admin>  urouteconfig  12  5 
done . 

switch :  adinin>  urouteshow  1/1  2 
Local  Domain  ID:  1 

In  Port        Domain        Out  Port        Metric        Hops        Flags        Next  (Dom, 
Port) 


1  2  5  500  1  S  2,5 

See  also 

conf igShow 
interf aceShow 
urouteRemove 
urouteShow 
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urouteRemove 

Removes  a  static  route. 

Synopsis 

urouteremove  InArea  Domain 

Availability 

admin 

Description 

Use  this  command  to  remove  a  previously  configured  static  route. 

After  tfiis  command  is  issued,  tfie  route  to  Domain  for  InArea  might  or  might  not  change.  It  changes  if  the 
previous  static  route  vvas  not  along  a  minimum-cost  path.  Also,  after  this  command  is  issued,  the  load 
sharing  to  Domain  is  reevaluated. 

InArea  can  be  either  an  F  Port  or  an  E_Port. 

Operands 

This  command  has  the  following  operands: 

InArea  The  port  that  is  statically  routed. 

Domain  The  destination  domain. 

Examples 

To  remove  a  static  route  for  all  traffic  coming  in  from  port  1  and  addressed  to  domain  2: 

switch :  ac3inin>  urouteremove  1  2 
done . 

See  also 

dlsShow 
conf igShow 
urouteConf ig 
urouteShow 


708   Fabric  OS  commands 


urouteShow 


Displays  unicast  routing  information. 


Synopsis 


urouteshow   [slotnumber/ ]  [portnumber]  [,  domainnumber] 


Availability 

all  users 


Description 

Use  this  command  to  display  the  unicast  routing  information  for  a  port,  as  it  is  known  by  the  FSPF  path 
selection  and  routing  task.  The  routing  information  describes  how  a  frame  that  is  received  from  a  port  on 
the  local  switch  is  to  be  routed  to  reach  a  destination  switch. 


The  following  information  displays: 

Domain  number  of  local  switch. 
Port  from  which  a  frame  is  received. 
Destination  domain  of  incoming  frame. 
Port  to  which  the  incoming  frame  is  to  be  forwarded. 
Cost  of  reaching  the  destination  domain. 
Maximum  number  of  hops  required  to  reach  the  destination 


Local  Domain  ID 

In  Port 

Domain 

Out  Port 

Metric 

Hops 


Flags 


Next  (Dom,  Port) 


domain. 

Indicates  if  route  is  dynamic  (D)  or  static  (S).  A  dynamic  route  is 
discovered  automatically  by  the  FSPF  path  selection  protocol.  A 
static  route  is  assigned  using  the  command  urouteConf  ig. 

Domain  and  port  number  of  the  next  hop.  These  are  the  domain 
number  and  the  port  number  of  the  switch  to  which  Out  Port  is 
connected. 


The  information  provided  by  this  command  should  match  what  is  provided  by  portRouteShow  and 
topologyShow. 


Operands 


This  command  has  the  following  operands: 


slotnumber 


portnumber 


doma i nn umber 


Specify  the  slot  number  of  the  input  port  whose  routes  are 
displayed,  followed  by  a  forward  slash  (/)  (for  bladed  systems 
only). 

Specify  a  port  number.  Valid  values  for  port  number  vary, 
depending  on  the  switch  type.  Use  switchShow  to  display  a 
list  of  valid  ports.  This  operand  is  optional;  if  omitted,  the 
command  displays  routing  information  for  all  input  ports  in  the 
switch. 

Displays  routing  information  for  the  specified  domain.  This 
operand  is  optional;  if  omitted,  the  routing  information  for  all 
domains  in  the  fabric  is  displayed. 


Fabric  OS  5.0.0  command  reference  guide  709 


Examples 

To  display  the  routing  information  of  all  the  active  ports: 


switch :admin>  urouteshow 
Local  Domain  ID:  3 


In  Port        Domain        Out  Port 

Metric 

Hops 

Flags 

Next  (Dom, 

Port) 

0  111 

1000 

1 

D 

1 ,  0 

11                    2  0 

1500 

2 

D 

4,  0 

4  0 

500 

1 

D 

4,0 

16                    1  27 

1000 

1 

D 

1,  1 

27                    2  16 

1500 

2 

D 

4,16 

4  0 

500 

1 

D 

4,  0 

To  display  the  routing  information  of  port  1 1 

on  slot  1 : 

switch : admin>  urouteshow  1/11 

Local  Domain  ID:  3 

In  Port        Domain        Out  Port 

Metric 

Hops 

Flags 

Next  (Dom, 

Port) 

11                    2  16 

1500 

2 

D 

4 ,  16 

4  16 

500 

1 

D 

4,  16 

To  display  the  routing  information  of  port  1 1  to  domain 

4  only: 

switch : admin>  urouteshow  1/11, 

4 

Local  Domain  ID:  3 

In  Port        Domain        Out  Port 

Metric 

Hops 

Flags 

Next  (Dom, 

Port) 

11                    4  16 

500 

1 

D 

4,  16 

See  also 

portRouteShow 
topologyShow 
urouteConf ig 
urouteRemove 
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userConfig 

Manages  user  accounts. 

Synopsis 

userconfig   [actions]  [arguments] 

Availability 

all  users 

Description 

Use  this  command  to  display,  add,  delete,  change,  or  recover  switch  accounts.  You  can  create  new  login 
accounts  to  manage  a  switch.  These  accounts  take  on  the  permission  or  role  of  the  default  admin  or  user 
account.  When  the  command  completes,  account  name  and  other  attributes  are  saved  persistently.  In  a 
platform  supporting  multiple  domains,  the  affected  accounts  apply  only  to  the  switch  domain  that  the 
command  was  executed. 

In  secure  mode,  the  actions  associated  with  this  command  to  add,  delete,  change  or  recover  accounts  are 
allowed  only  on  the  primary  FCS  switch.  The  primary  FCS  switch  distributes  the  update  to  the  entire  fabric. 
As  a  result,  all  switches  supporting  customer-defined  accounts  will  have  the  same  account  database.  All 
accounts  that  not  consistent  with  the  primary  FCS  switch  will  be  deleted  and  saved  in  the  backup 
database.  Administrators  can  use  the  --recover  action  to  restore  the  accounts. 

Operands 

Without  any  specified  action,  the  command  prints  out  the  usage.  The  operands  are  as  follows: 

--show  options  Displays  current  or  backup  account  information. 

--add  username  Add  a  new  account  username  to  switch. 

[ options] 

--delete  username  Delete  an  account  username  from  the  switch. 

--change  username  Change  attributes  for  an  account  username. 

[ options] 

--recover  Recover  one  or  more  accounts  from  backup  created  by  Secure 

Fabric  OS  operations. 

'2^^  NOTE:    The  -show  action  is  the  only  one  available  to  accounts  with  user  permission.  All  other  actions 
require  the  admin  permission. 
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The  following  sections  describe  of  each  action  type. 


--show  username   \    [-a   |  -b] 

Displays  information  about  the  current  login  account,  account 
named  username  or  all  accounts  either  in  active  or  backup 
account  database. 

If  running  from  an  account  with  user  permission,  the  command  can 
only  display  information  about  that  account.  The  following  table 
lists  the  result  of  different  combination  of  options. 


username 

-a 

-b 

Accounts 
displayed 

No 

No 

No 

Current  login 

Yes 

No 

No 

username 

No 

Yes 

No 

All  accounts 

Yes 

Yes 

No 

Not  valid 

No 

No 

Yes 

All  backup 
accounts 

Yes 

Yes 

Yes 

Not  valid 

--add  username  -r  rolename  -d  description 

Add  a  new  account  named  username  to  the  switch,  with  the  given 
authorization  of  rolename.  The  -d  option  gives  a  text  description  for 
the  new  account.  This  command  also  prompts  for  an  initial 
password. 

The  following  rules  apply  to  add  a  new  account: 

1.  username  must  be  unique  and  is  case  sensitive. 

2.  username  must  begin  with  a  letter  and  contain  only  letters, 
numbers  and  underscore. 

3.  The  maximum  length  of  username  is  40  characters. 

4.  description  is  optional.  The  maximum  length  is  40  printable 
ASCII  characters. 

5.  rolename  must  be  either  user  or  admin  in  nonsecure  mode;  it 
must  be  user,  admin,  or  nonfcsadmin  in  secure  mode. 

6.  There  can  be  maximum  1 5  customer  created  accounts  for  a 
switch. 

-delete  username  Delete  an  existing  account  named  username  from  the  switch.  This 

action  does  not  take  any  options.  It  prompts  for  the  confirmation 
before  proceeding.  Once  an  account  is  deleted,  the  CLI  sessions 
associated  with  the  account  will  be  terminated.  The  following  rules 
apply  to  delete  an  account: 

1 .  Cannot  delete  any  default  accounts. 

2.  An  account  cannot  delete  itself. 
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--change  username   [-r  rolename]    [-d  description]    [-e  yes    |  no] 

Change  attributes  for  an  existing  account,  named  username,  in  the 
switch.  The  -r  option  specifies  change  to  authorization  rolename. 
The  -d  option  specifies  change  to  description.  The  -e  option 
expects  either  yes  or  no  to  enable  or  disable  an  account.  Once  an 
account  is  disabled,  the  CLI  sessions  associated  with  the  account 
are  terminated.  The  following  rules  apply  to  change  an  account: 

1 .  Cannot  change  the  rolename  or  description  of  any  default 
accounts. 

2.  Cannot  change  the  rolename  or  description  for  accounts 
at  the  same  or  higher  authorization  level. 

3.  An  account  cannot  change  the  rolename  of  itself. 

4.  Except  the  default  root  account,  no  account  can  disable  itself. 

-recover  Recover  all  accounts  from  backup  database.  The  backup  database 

is  created  in  Secure  Fabric  OS,  when  certain  operations  cause  a 
switch  to  delete  some  of  its  customer  created  accounts.  For  details, 
read  the  secure  mode  description.  Once  accounts  have  been 
recovered,  the  accounts  in  the  backup  database  are  still  present. 

Examples 

To  add  a  new  account: 

switch : admin>  userconfig  --add  joan  -r  admin  -d  "joan  hoy" 

Setting  initial  password  for  joan 
Enter  new  password: 
Re-type  new  password: 

Account  joan  has  been  successfully  added. 
To  display  current  account  information: 

switch : admin>  userconfig  --show  joan 

Account  name:  joan 
Role:  admin 
Description:  Joan  Hoy 
Enabled:  Yes 

To  change  account  attributes: 

 ,  1 

switch : admin>  userconfig  --change  joan  -r  user-e  no 
Attribute  for  account  joan  has  been  successfully  changed. 

See  also 

none 
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version 

Displays  firmware  version  information. 

Synopsis 

version 

Availability 

all  users 

Description 

Use  this  command  to  display  firmware  version  information  and  build  dates. 
The  following  information  displays: 


Kernel  Displays  the  version  of  switch  kernel  operating  system 

Fabric  OS  Displays  the  version  of  switch  Fabric  OS 

Made  on  Displays  the  build  date  of  firmware  running  in  switch 

Flash  Displays  the  build  date  of  firmware  stored  in  flash  proms 

BootProm  Displays  the  version  of  the  firmware  stored  in  the  boot  PROM 


Usually  the  Made  on  and  Flash  dates  are  the  same,  because  the  switch  starts  running  flash  firmware  at 
power-on.  However,  in  the  time  period  between  f  irmwareDownload  and  the  next  reboot,  the  dates 
can  differ. 

Operands 

none 

Examples 

To  display  the  firmware  version  information  in  a  switch: 


switch : admin>  version 

Kernel : 

2 . 4 . 19 

Fabric  OS: 

v4  .  4  .  0 

Made  on : 

Mon  Oct  4 

09 

27 

16 

2004 

Flash: 

Tue  Oct  5 

12 

13 

47 

2004 

BootProm: 

3 .1.18 

See  also 

f irmwareDownload 
reboot 
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voltShow 

Displays  current  level  of  the  voltage  sensors  on  a  system. 

Synopsis 

voltshow 

Availability 

admin 

Description 

Use  this  command  to  display  information  about  a  switch's  voltage  levels.  The  format  of  the  display  varies 
according  to  the  sv/itch  model,  the  number  of  voltages  on  the  device,  and  the  number  of  voltage  sensors 
present. 

This  command  displays  the  follovving  fields: 

FRU  Type  One  of  the  following  values:  CHASSIS,  FAN,  I2C,  Control, 

CFlash,  POWER  SUPPLY,  SW  BLADE  (switch),  CP  BLADE 
(control  processor),  WWN  (World  Wide  Name),  or 
UNKNOWN. 

Number  Slot  or  unit  number,  if  applicable. 

Voltage  levels  The  measured  voltage  for  these  designated  voltage  levels: 

1 .2  or  1 .8  volts  (depending  on  the  ASIC  type),  2.5  volts,  3.3 
volts, 

5  volts,  1 2  volts,  48  volts,  and  53  volts. 

If  a  voltage  level  is  above  its  programmed  maximum,  it  has  a 
plus  (+)  appended;  if  it  is  below  its  programmed  minimum,  a 
minus  (■)  is  appended.  Nonapplicable  voltage  levels  are 
displayed  as  a  dash  (■). 


Operands 

none 


Fabric  OS  5.0.0  command  reference  guide  71 5 


Examples 

To  display  the  voltage  levels  on  a  system: 

switch: admin>  voltshow 

FRU  TYPE  -  Number  1.8/1.2V  2.5V     3.3V     5V         12V         48V  53V 


SW  BLADE  Slot:  2  1.82  2.51  3.30  --  11.94 

SW  BLADE  Slot:  3  0.00  0.00  0.09  --  12.31 

CP  BLADE  Slot:  5  --  2.48  3.29  5.17  12.50 

CP  BLADE  Slot:  6  --  2.50  3.29  5.17  12.50 

SW  BLADE  Slot:  8  1.80  2.52  3.30  --  12.00 

SW  BLADE  Slot:  9  1.80  2.51  3.97+  --  11.94 

SW  BLADE  Slot:  10  1.82  2.52  3.29  --  11.94 

FAN  Unit:    1  --  —         —  —  --         47.49  52.50 

FAN  Unit:   2  --  —         —  —  --         47.49  52.23 

FAN  Unit:   3  --  —         —  —  --         45.50-  52.23 

Sensor  Status:  +  =  above  max,    -  =  below  min. 


See  also 

sensorShow 
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wwn 


Displays  a  switch  World  Wide  Name  (WWN). 

Synopsis 

wwn 

Availability 

all  users 

Description 

Use  this  command  to  display  the  WWN  of  a  switch.  All  switches  have  a  numeric  address  that  is  the 
unique  Fibre  Channel  address  used  for  communicating  with  the  switch.  The  WWN  displays  in  the  output 

of  the  switchShow  command. 


NOTE:    When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

none 

Examples 

To  display  the  switch  WWN: 

switch :  adinin>  wwn 
10:00:00:60:69:00:54:e9 

See  also 

switchShow 
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zoneAdd 

Adds  a  member  to  the  zone. 

Synopsis 

zoneadd  " zoneName" ,   " member ; member" 

Availability 

admin 


1^)f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  add  one  or  more  members  to  an  existing  zone. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cf  gEnable  command. 

NOTE:   When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  sv/itch. 

Operands 

The  following  operands  are  required: 

zoneName  Specify  the  name  of  an  existing  zone,  in  quotation  marks.  This 

operand  is  required. 

member  Specify  a  member  or  list  of  members  to  be  added,  in  quotation 

marks,  separated  by  semicolons.  Valid  values  can  be  one  or  more  of 
the  following: 

A  switch  domain  and  port  area  number  pair;  for  example,  2,  20. 
View  the  area  numbers  for  ports  using  the  switchShow  command. 

Node  or  port  WWN. 
QuickLoop  ALPA. 
Zone  alias  name. 

Examples 

To  add  aliases  for  three  disk  arrays  to  Blue_zone: 

switch : admin>  zoneadd  "Blue_Zone",    "arrayS;   array4;  arrayS" 

See  also 

zoneCreate 
zoneDelete 
zoneRemove 
zoneShow 
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zoneCreate 


Creates  a  zone. 

Synopsis 

zonecreate  " zonename  ,   " member ; member" 

Availability 

admin 


NOTE:    This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  create  a  new  zone. 

A  zone  name  is  a  C-style  name  beginning  with  a  letter  and  followed  by  any  number  of  letters,  digits,  and 
underscore  characters.  Names  are  case  sensitive;  for  example,  Zone_l  indicates  a  different  zone  than 
zone_l.  Spaces  are  ignored.  Zone  names  are  limited  to  64  characters. 

The  zone  member  list  must  have  at  least  one  member.  The  members  are  described  by  a  list  of  member 
definitions,  separated  by  semicolons. 

Specify  ports  by  domain  and  port  area  number.  The  values  are  entered  as  a  pair  of  numbers  s ,  p.  The  s 
is  the  switch  number  (domain  ID)  and  p  is  the  port  area  number.  For  example, 

2 ,   2  0  specifies  port  area  number  20  on  switch  domain  2.  When  a  zone  member  is  specified  by  port 
area  number,  all  devices  connected  to  that  port  are  in  the  zone.  If  this  port  is  an  arbitrated  loop,  all 
devices  on  the  loop  are  in  the  zone. 

Specify  a  World  Wide  Name  as  eight  hex  numbers  separated  by  colons:  for  example, 
10:00:00:60:69:00:00:  8a.  Zoning  compares  the  WWN  with  the  node  and  port  names  presented 
by  a  device  in  a  login  frame  (FLOG!  or  PLOGI).  When  a  zone  member  is  specified  by  node  name,  then  all 
ports  on  that  device  are  in  the  zone.  When  a  zone  member  is  specified  by  port  name,  then  only  that  single 
device  port  is  in  the  zone. 

Specify  a  QuickLoop  AL_PA  as  a  QuickLoop  name  followed  by  a  list  of  AL_PAs:  for  example, 
gloopl  [01,02].  QuickLoop  names  have  the  same  format  as  zone  names  and  are  created  with  the 
qloopCreate  command  to  define  a  switch  or  pair  of  switches  that  form  the  QuickLoop. 

Specify  a  zone  alias  name  using  the  same  format  as  a  zone  name.  A  zone  alias  is  created  with  the 
aliCreate  command.  The  alias  must  resolve  to  a  list  of  one  or  more  of  the  following: 

•  A  switch  domain  and  port  area  number  pair.  View  the  area  numbers  for  ports  using  the  switchShow 
command. 

•  World  Wide  Names. 

•  QuickLoop  AL_PAs. 

The  types  of  zone  members  used  to  define  a  zone  can  be  mixed.  For  example,  a  zone  defined  with  the 
members  2  , 12  ;  2  , 14;   10:00:00:60:69:00:00:  8a  would  contain  all  devices  connected  to  switch 
2,  ports  1  2  and  14,  and  to  the  device  with  the  World  Wide  Name  10:00:00:60:69:00:00:  8a 
(either  node  name  or  port  name),  at  the  port  in  the  fabric  to  which  it  is  connected. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cf  gEnable  command. 
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NOTE:  Use  this  command  to  create  a  broadcast  zone.  This  is  a  special  zone  used  to  specify  those  nodes 
that  can  receive  broadcast  traffic.  Broadcast  traffic  is  usually  meant  for  servers  and  not  for  storage  devices. 
This  zone  must  be  named  broadcast.  Only  one  broadcast  zone  can  exist  within  a  fabric.  This  type  of  zone 
is  hardware  enforced;  the  switch  controls  data  transfer  to  a  port. 

When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

The  following  operands  are  required: 

zoneName  Specify  the  name  of  an  existing  zone,  in  quotation  marks.  This 

operand  is  required. 

member  Specify  a  member  or  list  of  members  to  be  added,  in  quotation 

marks,  separated  by  semicolons.  Valid  values  can  be  one  or  more  of 
the  following: 

A  switch  domain  and  port  area  number  pair;  for  example,  2,  20. 
View  the  area  numbers  for  ports  using  the  switchShow  command. 

Node  or  port  WWN. 
QuickLoop  AL_PA. 
Zone  alias  name. 

Examples 

To  create  three  zones  using  a  combination  of  port  numbers  and  zone  aliases: 


switch: 

:  ac3inin> 

zonecreate 

" Red_zone " , 

"1,0;  loopl" 

switch: 

: admin> 

zonecreate 

" Blue_zone " , 

"1,1;   arrayl ; 

1,2; 

array2 " 

switch: 

:  adinin> 

zonecreate 

"Green_zone " 

,    "1,0;  loopl; 

1,2; 

array2 " 

See  also 

zone Add 
zoneDelete 
zoneRemove 
zoneShow 
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zoneDelete 

Deletes  a  zone. 

Synopsis 


zonedelete  zonename 


Availability 

admin 


I^Jf  NOTE:    This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  delete  a  zone. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 


NOTE:   When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary 

Operands 

This  command  has  the  following  operand: 

zonename       Name  of  the  zone  to  be  deleted,  in  quotation  marks.  This  operand  is 
required. 

Examples 

To  delete  the  zone  Blue  zone: 


FCS  switch. 


switch : adinin>  zonedelete  "Blue_zone" 


See  also 

zone Add 
zoneCreate 
zoneRemove 
zoneShow 
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zoneHelp 

Displays  help  information  for  zone  commands. 

Synopsis 

zonehelp 

Availability 

all  users 

Description 

Use  this  command  to  display  help  information  for  zone  commands. 

Operands 

none 

Examples 

To  display  zone  command  help  information: 


See  also 


switch : admin>  zonehelp 

aliAdd 

aliCreate 

aliDelete 

aliRemove 

aliShow 

Add  a  member  to  a  zone  alias 

Create  a  zone  alias 

Delete  a  zone  alias 

Remove  a  member  from  a  zone  alias 

Print  zone  alias  information 

f azoneAdd 
f azoneCreate 
f azoneDelete 
f azoneShow 

Add  a  member  to  a  fabric  assist  zone 
Create  a  fabric  assist  zone 
Delete  a  fabric  assist  zone 
Print  Fabric  Assist  Zone  information 

cf gClear 

cf gDisable 

cf gEnable 

cf gSize 

c  f gTransAbor t 

Clear  all  zone  configurations 
Disable  a  zone  configuration 
Enable  a  zone  configuration 
Print  size  details  of  zone  database 
Abort  zone  configuration  transaction 

aliAdd 

aliCreate 

aliasDelete 

aliRemove 

aliShow 

cf gClear 
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cf gDisable 
cf gEnable 
cf gSize 
cfgTrans Abort 
f aZoneAdd 
f aZoneCreate 
f aZoneDelete 
f aZoneShow 
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zoneObjectCopy 

Copies  a  zone  object. 

Synopsis 

zoneObjectCopy  " objectName" ,  "newName" 

Availability 

admin 


\^^}f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  copy  a  zone  object  to  a  new  zone  object.  The  resulting  object  has  the  same  type  as 
the  original  object.  You  can  use  this  command  for  all  zone  object  types,  including  cfg,  zone,  and  alias. 

A  zone  configuration  name  must  begin  with  a  letter  that  can  be  followed  by  any  number  of  letters, 
numbers,  and  underscores.  Names  are  case  sensitive;  for  example,  Cf  g_l  and  cf  g_l  are  different  zone 
configurations.  Spaces  are  ignored. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cf  gEnable  command. 

Refer  to  the  zoneCreate  command  for  more  information  on  name  and  member  specifications. 


NOTE:   When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  operands: 

objectName  The  name  of  the  object  that  you  want  to  copy.  This  operand  is  required. 

newName  The  name  of  the  object  that  you  want  created.  This  operand  is  required. 

Examples 

To  create  a  configuration  containing  three  zones: 


switch : admin>  cfgShow  "*" 

cfg:       USA_cfg        Red_zone;  White_ 

_zone , 

Blue_ 

_zone 

switch: admin>  zoneObjectCopy  "USA_cfg", 

"  UK_ 

_cf  g" 

switch :  adinin>  cfgShow  "*" 

cfg:       UK_cfg          Red_zone;  White_ 

_zone , 

Blue_ 

_zone 

cfg:       USA_cfg        Red_zone;  White_ 

_zone , 

Blue_ 

_zone 
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See  also 

cf gAdd 
cf gClear 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cf gShow 

zoneObj  ectRename 
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zoneObjectExpunge 


Expunges  a  zone  object. 

Synopsis 

zoneObj  ectExpunge  " obj ectName" 

Availability 

admin 


1^)f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  expunge  a  zone  object.  In  addition,  to  performing  a  simple  delete,  this  command 
also  removes  the  object  from  the  member  lists  of  all  other  objects.  Afterv/ards,  this  object  is  completely 
removed  from  the  database.  You  can  use  this  command  for  all  zone  object  types,  including  cfg,  zone,  and 
alias. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  sv/itch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

NOTE:    When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  sv/itch. 

Operands 

This  command  has  the  follov/ing  operand: 

objectName  The  name  of  the  object  that  you  v/ant  to  expunge.  This  operand  is  required. 
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Examples 

To  create  a  configuration  containing  three  zones: 


switch : ad[nin>  cfgShow 

Defined 

configuration : 

cf  g : 

USA_cfg        Red_zone;  White_zone; 

Blue_ 

zone 

zone : 

Blue_zone 

1,1;   arrayl ;   1,2;  array2 

zone : 

Red_zone 
1,0;  loopl 

zone : 

White_zone 
1,3;  1,4 

alias : 

arrayl     21 : 00 : 00 : 2 0 : 37 : Oc : 76 : 8c ; 

21 

00 

:00: 

20 

37 

Oc 

71 

02 

alias : 

array2      21 : 00 : 00 : 20 : 37 : Oc : 76  :  22 ; 

21 

00 

:00: 

20 

37 

Oc 

76 

28 

alias : 

loopl  21:00:00:20:37:0c:76:85; 

21 

00 

:00: 

20 

37 

Oc 

71 

df 

switch : adinin>  zoneObj ectExpunge  "White_zone" 

switch : adinin>  cfgShow 

Defined 

configuration : 

cfg: 

USA_cfg        Red_zone;  Blue_zone 

zone : 

Blue_zone 

1,1;   arrayl ;   1,2;  array2 

zone : 

Red_zone 
1,0;  loopl 

alias : 

arrayl     21:00:00:20:37: 0c:76: Be; 

21 

00 

:00: 

20 

37 

Oc 

71 

02 

alias : 

array2      21 : 00 : 00 : 20 : 37 : Oc : 76 : 22 ; 

21 

00 

:00: 

20 

37 

Oc 

76 

28 

alias : 

loopl  21:00:00:20:37:0c:76:85; 

21 

00 

:00: 

20 

37 

Oc 

71 

df 

See  also 

cf gAdd 
cf gClear 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cfgShow 

zoneObj  ectCopy 
zoneObj  ectRename 
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zoneObjectRename 


Renames  a  zone  object. 

Synopsis 

zoneObjectRename  " obj ectName" ,  "newName" 

Availability 

admin 


1^)f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  rename  a  zone  object.  You  can  use  this  command  for  all  zone  object  types, 
including  cfg,  zone,  and  alias. 

A  zone  configuration  name  must  begin  with  a  letter  that  can  be  followed  by  any  number  of  letters, 
numbers,  and  underscores.  Names  are  case  sensitive;  for  example,  Cf  g_l  and  cf  g_l  are  different  zone 
configurations.  Spaces  are  ignored. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cf  gEnable  command. 

Refer  to  the  zoneCreate  command  for  more  information  on  name  and  member  specifications. 


NOTE:   When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Operands 

This  command  has  the  following  operands: 

objectName  The  name  of  the  object  that  you  want  to  rename.  This  operand  is  required. 

newName  The  new  name  of  the  object.  This  operand  is  required. 

Examples 

To  create  a  configuration  containing  three  zones: 


switch :  ac3inin>  cfgShow  "*" 

cfg:       USA_cfg  Red_zone 

White_zone;  Blue_zone 

switch : admin>  zoneObjectRename 

USA_cfg",  "UK_cfg" 

switch :  adinin>  cfgShow  "*" 

cfg:       UK_cfg  Red_zone 

White_zone;  Blue_zone 
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See  also 

cf gAdd 
cf gClear 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cf gShow 

zoneObj  ectCopy 
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zoneRemove 


Removes  a  member  from  a  zone. 

Synopsis 

zoneremove  " zonename  ,   " member ; member" 

Availability 

admin 


NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  remove  one  or  more  members  from  an  existing  zone. 

The  member  list  is  located  by  an  exact  string  match;  therefore,  it  is  important  to  maintain  the  order  v/hen 
removing  multiple  members.  For  example,  if  a  zone  contains  arrayl ;  array3  ;  array4,  removing 
arrays  ;   array4  succeeds  but  removing  array4  ;   arrayS  fails. 

If  all  members  are  removed,  the  zone  is  deleted. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  sv/itch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

NOTE:   When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Operands 

The  follovving  operands  are  required: 

zoneName  Specify  the  name  of  an  existing  zone,  in  quotation  marks.  This 

operand  is  required. 

member  Specify  a  member  or  list  of  members  to  be  added,  in  quotation 

marks,  separated  by  semicolons.  Valid  values  can  be  one  or  more  of 
the  follovving: 

A  switch  domain  and  port  area  number  pair;  for  example,  2,  20. 
View  the  area  numbers  for  ports  using  the  switchShow  command. 

Node  or  port  WWN. 
QuickLoop  AL_PA. 
Zone  alias  name. 

Examples 

To  remove  array2  from  Blue_zone: 


switch 

adinin>  zoneremove 

" Blue_zone " , 

" array2 " 

switch 

admin>  zoneremove 

" Blue_zone " , 

"2,20" 
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See  also 

zone Add 
zoneCreate 
zoneDelete 
zoneShow 
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zoneShow 

Displays  zone  information. 

Synopsis 

zoneshow   ["pattern"]  [,  mode] 

Availability 

all  users 


1^)f  NOTE:   This  command  requires  an  HP  Advanced  Zoning  license. 


Description 

Use  this  command  to  display  zone  configuration  information. 

If  no  parameters  are  specified,  all  zone  configuration  information  (both  defined  and  enabled)  is 
displayed.  Refer  to  cf  gShow  for  a  description  of  this  display. 

If  a  parameter  is  specified,  it  is  used  as  a  pattern  to  match  zone  configuration  names,  and  those  that 
match  in  the  defined  configuration  are  displayed. 

1^)f  NOTE:    When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  PCS  switch. 


Operands 

The  following  operand  is  optional: 

pattern         A  POSIX-style  regular  expression  used  to  match  zone  configuration  names.  The 
pattern  must  be  enclosed  in  quotation  marks.  Patterns  can  contain: 

A  question  mark  (?),  which  matches  any  single  character. 

An  asterisk  (*),  which  matches  any  string  of  characters. 

Ranges,  which  match  any  character  within  the  range:  for  example,  [0-9]  or  [a-f]. 

mode  Specify  0  to  display  the  contents  of  the  transaction  buffer  (the  contents  of  the 

current  transaction),  or  specify  1  to  display  the  contents  of  the  flash  memory.  The 
default  value  is  0.  This  operand  is  optional. 

Examples 

To  display  all  zones  beginning  with  the  letters  A  through  C: 

switch : admin>  zoneshow  "[A-C]*" 

zone:   Blue_zone  1,1;   arrayl ;   1,2;  arraY2 
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See  also 

zone Add 
zoneCreate 
zoneDelete 
zoneRemove 
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3    Licensed  product  commands 


This  chapter  summarizes  the  commands  that  are  only  available  with  a  license  key. 

•  Advanced  zoning  commands,  page  735 

•  QuickLoop  Fabric  Assist  mode  commands,  page  736 

•  Extended  Fabrics  command,  page  737 

•  Fabric  Watch  commands,  page  737 

•  ISL  Trunking  commands,  page  737 

•  Advanced  Performance  Monitoring  commands,  page  738 

•  Secure  Fabric  OS  commands,  page  739 

NOTE:  For  more  information  about  Advanced  Zoning,  QuickLoop,  Extended  Fabrics,  Fabric  Watch, 
Trunking,  or  Performance  Monitoring,  refer  to  the  HP  StorageWorks  Fabric  OS  4.x  features  overview. 


Advanced  zoning  commands 

The  follov/ing  commands  are  available  v/ith  the  purchase  of  a  HP  Advanced  Zoning  license  key. 
Table  21    Zoning  commands 


Command 

Description 

Zone  Alias 

aliAdd 

Adds  a  member  to  a  zone  alias. 

aliCreate 

Creates  a  zone  alias. 

aliDelete 

Deletes  a  zone  alias. 

aliRemove 

Removes  a  member  from  a  zone  alias. 

Zoning 

zoneAdd 

Adds  a  member  to  a  zone. 

zoneCreate 

Creates  a  zone. 

zoneDelete 

Deletes  a  zone. 

zoneRemove 

Removes  a  member  from  a  zone. 

Zone  Configuration 

cf gAdd 

Adds  a  zone  to  a  zone  configuration. 
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Table  21    Zoning  commands  (continued) 


Command 

Description 

cfgCreate 

Creates  a  zone  configuration. 

cfgDelete 

Deletes  a  zone  configuration. 

cfgRemove 

Removes  a  zone  from  a  zone  configuration. 

Zone  Management 

cfgClear 

Clears  all  zone  configurations. 

cfgDisable 

Disables  a  zone  configuration. 

cfgEnable 

Enables  a  zone  configuration. 

cf gSave 

Saves  zone  configurations  in  flash  memory. 

cfgTransAbort 

Aborts  tfie  current  zoning  transaction. 

zoneOb j  ectCopy 

Copies  a  zone  object. 

zoneOb j  ectExpunge 

Expunges  a  zone  object. 

zoneOb j  ectRename 

Renames  a  zone  object. 

QuickLoop  Fabric  Assist  mode  commands 

The  following  commands  are  for  QuickLoop  Fabric  Assist  mode. 
Table  22    QuickLoop  Fabric  Assist  mode  command 


Command 

Description 

f aZoneAdd 

Adds  member(s)  to  an  existing  QuickLoop  Fabric  Assist  zone. 

f aZoneCreate 

Creates  a  QuickLoop  Fabric  Assist  zone. 

f aZoneDelete 

Deletes  an  existing  QuickLoop  Fabric  Assist  zone. 

f aZoneRemove 

Removes  member(s)  from  an  existing  QuickLoop  Fabric  Assist  zone. 

qloopAdd 

Adds  a  member  to  a  QuickLoop. 

qloopCreate 

Creates  a  QuickLoop. 

qloopDelete 

Deletes  a  QuickLoop. 

qloopRemove 

Removes  a  member  from  a  QuickLoop. 

qloopShow 

Displays  QuickLoop  information. 

NOTE:   The  QuickLoop  Fabric  Assist  mode  is  not  available  on  Fabric  OS  v4.x. 
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Extended  Fabrics  command 


The  following  command  is  available  with  the  purchase  of  a  HP  Extended  Fabrics  license  key. 
Table  23    Extended  Fabrics  commands 


Command 

Description 

portCfgLongDi stance 

Configure  a  port  to  support  long-distance  links. 

Fabric  Watch  commands 


The  following  commands  are  available  with  the  purchase  of  a  HP  Fabric  Watch  license  key. 
Table  24    Fabric  Watch  commands 


Command 

Description 

fwClassInit 

Initialize  all  classes  under  Fabric  Watch. 

fwConf igReload 

Reload  the  Fabric  Watch  configuration. 

fwConf igure 

Display  and  enable  modification  of  the  Fabric  Watch 
configuration  and  status. 

fwShow 

Display  the  thresholds  monitored  by  Fabric  Watch. 

fwAlarmsFi Iter Set 

Enable  or  disable  alarms  for  Fabric  Watch. 

fwAlarmsFi Iter Show 

Display  alarm  filtering  for  Fabric  Watch. 

fwFruCfg 

Display  and  changes  FRU  state  alert  configuration. 

fwMailCfg 

Configure  email  alerts  in  Fabric  Watch. 

fwSetToDefault 

Set  boundary  and  alarm  levels  to  the  default  values. 

fwSetToCustom 

Set  boundary  and  alarm  levels  to  custom  values. 

ISL  Trunking  commands 

The  following  commands  are  available  with  the  purchase  of  a  HP  Trunking  license  key.  For  more  detailed 
information  about  trunking  refer  to  the  HP  StorageWorks  Fabric  OS  4.x  procedures  user  guide. 

Table  25    HP  Trunking  commands 


Command 

Description 

portCf gTrunkPort 

Configure  a  port  for  trunking. 

swi  tchC  f gTrunk 

Configure  a  sv\/itch  for  trunking. 

trunkDebug 

Debug  a  trunk  link  failure. 
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Advanced  Performance  Monitoring  commands 

The  following  commands  are  available  with  the  purchase  of  a  HP  Advanced  Performance  Monitoring 
license  key. 

Table  26    Performance  Monitoring  commands 


Command 

Description 

perf AddEEMonitor 

Add  an  end-to-end  monitor  to  a  port. 

perf AddlPMonitor 

Add  an  IP  monitor  to  a  port. 

perf AddReadMoni tor 

Add  a  SCSI  Read  monitor  to  a  port. 

per f AddRWMonitor 

Add  a  SCSI  Read  and  Write  monitor  to  a  port. 

perfAddSCSIMonitor 

Add  a  SCSI  traffic  frame  monitor  to  a  port. 

per f AddUserMonitor 

Add  a  user-defined  monitor  to  a  port. 

per f AddWriteMonitor 

Add  a  SCSI  Write  monitor  to  a  port. 

per f Cf gClear 

Clear  the  performance  monitoring  settings  from  flash  memory. 

per fCfgRes tore 

Restore  performance  monitoring  settings  from  flash  memory. 

perfCfgSave 

Save  the  current  performance  monitoring  settings  to  flash  memory. 

perf ClearEEMoni tor 

Clear  statistics  counters  of  an  end-to-end  (EE)  monitor  on  a  port. 

per f ClearFilterMonitor 

Clear  statistics  counters  of  a  filter-based  monitor. 

perf ClrAlpaCrc 

Clear  an  AL_PA  device  CRC  count  by  the  port  and  AL_PA. 

perf DelEEMoni tor 

Delete  an  end-to-end  monitor  on  port. 

perfDelFilterMonitor 

Delete  a  filter-based  monitor. 

perf Set PortEEMask 

Set  overall  mask  for  end-to-end  (EE)  monitors. 

per f ShowAlpaCrc 

Display  the  AL_PA  CRC  count  by  port  or  by  AL_PA. 

perf ShowEEMoni tor 

Display  user-defined  end-to-end  monitors  on  a  port. 

per f ShowFilterMonitor 

Display  filter-based  monitors  for  a  port. 

perf ShowPortEEMask 

Display  the  current  end-to-end  mask  of  a  port. 
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Secure  Fabric  OS  commands 

The  following  commands  are  available  with  the  purchase  of  a  HP  Security  license  key.  For  more  detailed 
information  about  security,  refer  to  the  HP  StorageWorks  Secure  Fabric  OS  4.x  user  guide.) 

Table  27    HP  Secure  Fabric  OS  commands 


Command 

Description 

secFabricShow 

Displays  security  related  fabric  information. 

secFCSFai lover 

Enables  a  backup  PCS  switch  to  take  over  as  primary  PCS  switch. 

secHelp 

Display  information  about  security  telnet  commands. 

Enable  security  mode. 

secModeDi sable 

Disable  security  mode. 

secModeShow 

Display  if  security  mode  is  enabled  or  disabled. 

secNonFcsPasswd 

Set  the  admin  password  for  non-PCS  switches. 

secPolicyAbort 

Aborts  all  changes  to  the  defined  database  that  have  not  been 
saved. 

secPolicyActivate 

Apply  defined  policy  set  to  all  switches  in  the  fabric. 

secPolicyAdd 

Add  members  to  an  existing  policy. 

secPolicyCreate 

Create  a  new  policy. 

secPolicyDelete 

Delete  an  existing  policy. 

s ec Po 1 i cyDump 

Display  all  members  of  existing  policies. 

s  ec  Po 1 i  cyFC  SMove 

Move  a  member  in  the  PCS  policy. 

s  ec  Po 1 i  cyRemove 

Remove  members  from  an  existing  policy. 

secPolicySave 

Save  a  defined  security  policy  to  flash  memory  on  all  switches  in 
the  fabric. 

secPolicyShow 

Display  an  existing  security  policy. 

secStatsReset 

Reset  security  statistic  for  a  policy  or  all  policies  to  0. 

secStatsShow 

Display  security  statistic  for  a  policy  or  for  all  policies. 

secTempPasswdReset 

Reset  a  password  on  a  remote  switch. 

secTempPasswdSet 

Set  a  temporary  password  on  a  remote  switch. 

secTransAbort 

Abort  current  security  transaction. 

secVersionReset 

Reset  the  version  stamp  to  0. 
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4    Exclusive  primary  PCS  commands 


This  chapter  summarizes  the  commands  that  are  available  on  the  primary  FCS  only  when  the  security 
feature  is  installed  and  enabled. 


Commands  exclusive  to  the  primary  FCS 

The  following  commands  are  available  on  the  primary  FCS  only  when  security  is  installed  and  enabled. 
Table  28   Commands  exclusive  to  the  primary  FCS 


Command 

Notes 

agtCfgSet 

Can  be  run  on  all  sv/itches,  but  it  needs  to  be  run  on  the  primary  FCS  to  modify 
community  strings 

agtCf gDef ault 

Must  be  run  from  the  primary  FCS  switch. 

aliAdd 

Must  be  run  from  the  primary  FCS  switch. 

aliCreate 

Must  be  run  from  the  primary  FCS  switch. 

aliDelete 

Must  be  run  from  the  primary  FCS  switch. 

aliRemove 

Must  be  run  from  the  primary  FCS  switch. 

aliShow 

Must  be  run  from  the  primary  FCS  switch. 

cfgAdd 

Must  be  run  from  the  primary  FCS  switch. 

cf gClear 

Must  be  run  from  the  primary  FCS  switch. 

cf gCreate 

Must  be  run  from  the  primary  FCS  switch. 

cfgDelete 

Must  be  run  from  the  primary  FCS  switch. 

cf gDisable 

Must  be  run  from  the  primary  FCS  switch. 

cf gEnable 

Must  be  run  from  the  primary  FCS  switch. 

cf gRemove 

Must  be  run  from  the  primary  FCS  switch. 

cfgSave 

Must  be  run  from  the  primary  FCS  switch. 

cfgShow 

Can  be  run  on  all  FCS  switches. 

cf gTransAbort 

Must  be  run  from  the  primary  FCS  switch. 

cfgTransShow 

Must  be  run  from  the  primary  FCS  switch. 

date 

This  command  can  be  run  on  all  switches  to  view  the  current  date.  You  can  only 
modify  the  date  from  the  primary  FCS  switch. 

f aZoneAdd 

Must  be  run  from  the  primary  FCS  switch. 
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Table  28   Commands  exclusive  to  the  primary  FCS  (continued) 


Command 

Notes 

f aZoneCreate 

Must  be  run  from  the  primary  FCS  switch. 

f aZoneDelete 

Must  be  run  from  the  primary  FCS  switch. 

f aZoneRemove 

Must  be  run  from  the  primary  FCS  switch. 

f aZoneShow 

Must  be  run  from  the  primary  FCS  switch. 

msConf igure 

Can  be  run  on  all  switches,  but  it  does  not  display  ACL  in  secure  mode. 

msPlMgmt Deactivate 

Must  be  run  from  the  primary  FCS  switch. 

msPlMgmtActivate 

Must  be  run  from  the  primary  FCS  switch. 

msPlClearDB 

Must  be  run  from  the  primary  FCS  switch. 

msTdDisable 

mstddisable  "ALL"  must  be  run  from  the  primary  FCS  switch. 

msTdEnable 

mstdenable  "ALL"  must  be  run  from  the  primary  FCS  switch. 

passwd 

Must  be  run  from  the  primary  FCS  switch. 

secFabricShow 

Must  be  run  from  the  primary  FCS  switch. 

secModeDi sable 

Must  be  run  from  the  primary  FCS  switch. 

secNonFcs Passwd 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyAbort 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyActivate 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyAdd 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyCreate 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyDelete 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyDump 

Can  be  run  on  all  FCS  switches. 

secPolicyFCSMove 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyRemove 

Must  be  run  from  the  primary  FCS  switch. 

secPolicySave 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyShow 

Can  be  run  on  all  FCS  switches. 

secTempPasswdSet 

Must  be  run  from  the  primary  FCS  switch. 

secTempPasswdReset 

ii  i      1  1               f          1 1           ■             r/" c        -I  1 

Must  be  run  trom  the  primary  rCb  switch. 

secVersionReset 

Must  be  run  from  the  primary  FCS  switch.  Can  also  be  run  on  a  single 
non-FCS  switch  which  is  segmented  from  a  fabric. 

tsClockServer 

Can  be  run  on  all  switches  to  view  the  NTP  server's  IP  address.  You  can  only 
modify  the  NTP  server's  IP  address  on  the  primary  FCS  switch. 
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Table  28   Commands  exclusive  to  the  primary  FCS  (continued) 


Command 

Notes 

wwn 

TI    -                                      1                  1                                      II            -  1     1             1            -              1  1         \  A  A  A  /k  1      \  A  /-  1  1                       -  1 

mis  command  can  be  run  on  all  switches  to  view  the  WWN.  With  security 
enabled  the  WWN  of  a  switch  cannot  be  modified. 

zoneAdd 

Must  be  run  from  the  primary  FCS  switch. 

zoneCreate 

Must  be  run  from  the  primary  FCS  switch. 

zoneDelete 

Must  be  run  from  the  primary  FCS  switch. 

zoneRemove 

Must  be  run  from  the  primary  FCS  switch. 

zoneShow 

Must  be  run  from  the  primary  FCS  switch. 
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5    Commands  unique  to  Fabric  OS  v4.x 

This  chapter  summarizes  the  commands  that  are  unique  to  specific  versions  of  the  Fabric  OS. 


Command  and  Fabric  OS  versions 


The  following  commands  are  found  either  in  v4.x,  or  v3.x  but  not  all. 
Table  29   Command  comparison  between  Fabric  OS  v3.x  and  v4.x 


Found  only  in  v4.x 

Found  only  in  v3.x 

aliasDelete 

aliasjoin 

aiiasPurge 

aliasShow 

backplane test 

backport 

backspace 

bladeBeacon 

bladeDisable 

bladeDisable 

bladeEnable 

bsn 

chassisName 

chassisShow 

chipRegShow 

diagCommandShow 

diagEsdPorts 

diagFailLimit 

diagLoopId 

diagModePr 

diagPost 
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Table  29   Command  comparison  between  Fabric  OS  v3.x  and  v4.x  (continued) 


Found  only  in  v4.x 

Found  only  in  v3.x 

diagRetry 

diagShowTime 

diagSilkworm 

diagSkipTests 

f abPortShow 

f abStateClear 

f abStateShow 

f abSwitchShow 

f anDisable 

f anEnable 

fa  Show 

faStatsShow 

f i r mwa r e C omm i t 

f irmwareRestore 

f ruReplace 

fwFruCf g 

gblcShow 

haDisable 

haDump 

haEnable 

haFai lover 

haShow 

haSyncStart 

haSyncStop 

historyLastShow 

historyMode 

historyShow 

ifShow 

iteiriList 
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Table  29   Command  comparison  between  Fabric  OS  v3.x  and  v4.x  (continued) 


Found  only  in  v4.x 

Found  only  in  v3.x 

killTelnet 

licenseldShow 

mcastShow 

myld 

paritycheck 

pdShow 

pkiCreate 

pkiRemove 

pkiShow 

portcamShow 

portLogEventShow 

portLogReset 

portLogResize 

portLogTypeDi sable 

portLogTypeEnable 

ports tats64Show 

portSwap 

portSwapDi sable 

portSwapEnable 

portSwapShow 

powerOf f ListSet 

powerOf f ListShow 

qlDisable 

qlEnable 

qlPartner 

qlPortDisable 

qlPortEnable 

qlPortShowAll 

qlShow 
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Table  29   Command  comparison  between  Fabric  OS  v3.x  and  v4.x  (continued) 


Found  only  in  v4.x 

Found  only  in  v3.x 

qlStatsShow 

quietMode 

ramTest 

saveCore 

setEsdMode 

slotOf f 

slotOn 

slotPowerOf f 

slotPowerOn 

slotShow 

ssn 

switchDi sable 

switchReboot 

switchShutdown 

switchStart 

switchUptime 

systemVerif ication 
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6   Control  processor  commands 


This  chapter  lists  the  commands  available  when  logged  in  to  the  active  CP  and  standby  CP  in  a  Core 
Sv/itch  2/64  or  HP  StorageWorks  SAN  Sv/itch  Director  2/128. 


Commands  supported  on  the  active  CP 

When  logged  in  to  the  active  CP  on  a  Core  Switch  2/64,  you  must  specify  the  logical  switch  number  to 
which  you  are  connecting.  This  guarantees  that  any  commands  you  execute  are  run  on  the  desired  logical 
switch.  Once  you  have  selected  a  logical  switch,  the  full  set  of  commands  for  your  user  level  are  available. 


Commands  supported  on  the  standby  CP 

The  following  commands  are  supported  when  logged  into  the  standby  CP. 
Table  30   Commands  supported  on  the  standby  CP 


Command 

Description 

date 

Print/set  the  system  date  and  time. 

errClear 

Clear  error  log. 

err Dump 

Print  error  log  (no  page  breaks). 

errNvLogSlzeSet 

n-                      li'l/  1 

Kesize  nonvolatile  (persistent)  error  log. 

errNvLogSizeSize 

Display  persistent  error  log  configuration. 

errSaveLvlSet 

Set  error  save  level. 

errSaveLvlShov/ 

Get  error  save  level. 

errShow 

Print  error  log. 

f astBoot 

Reboot  this  switch,  bypassing  POST. 

f i r mwar e C omm i t 

Commit  firmware  to  stable  storage. 

f  i  rmwar eDownl oad 

Download  firmware  into  switch. 

f irmwareDownloadStatus 

Display  the  progress  and  status  of  firmwaredownload. 

f i rmwar eRes tore 

Restore  the  old  firmware  in  the  switch. 

fi rmwar eShow 

Display  firmware  versions  in  the  switch. 

h 

Print  shell  history. 

haDump 

Dump  HA  debug  data. 

haShow 

Print  High  Availability  status. 
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Table  30   Commands  supported  on  the  standby  CP  (continued) 


Command 

Description 

help 

Print  this  list. 

ifModeSet 

Set  the  link  operating  mode  for  a  network  interface. 

ifModeShow 

Display  the  link  operating  mode  for  a  network  interface. 

killTelnet 

Terminate  telnet/serial  login  sessions  interactively. 

memShow 

Display  memory  usage  in  the  system. 

my  Id 

Display  the  current  login  session  details. 

pdShow 

Display  information  from  panic  dump  file. 

reboot 

Reboot  the  standby  CP. 

saveCore 

FTP  or  remove  core  files  generated  by  daemons. 

switchName 

Print  this  switch's  name. 

tsTimeZone 

Display  time  zone. 

upTime 

Print  how  long  switch  has  been  up. 

version 

Print  firmware  version. 
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7   supports  how  reference 


This  chapter  explains  the  information  displayed  by  the  supportShow  command.  This  chapter  has  the 
following  sections: 

•  supportShow  control  commands,  page  751 

•  supportShow  command  groups,  page  751 

•  Proc  entry  information  displayed,  page  754 


supportShow  control  commands 

The  supportShow  command  is  used  to  display  support  information  by  executing  groups  of  preselected 
Fabric  OS  and  Linux  commands.  The  information  displayed  by  the  supportShow  command  can  be 
controlled  by  a  set  of  control  commands: 

supportShowCf  gShow  Display  which  groups  of  commands  are  enabled  to  display 

under  supportShow. 

supportShowCf  gEnable  Enable  a  group  of  commands  to  display  under 

supportShow. 

supportShowCf  gDisable        Disable  a  group  of  commands  from  displaying  under 

supportShow. 


supportShow  command  groups 

Table  31  displays  the  command  groups  under  supportshow,  and  which  Fabric  OS  or  Linux  commands 
are  executed  by  that  group. 


NOTE:  Many  of  the  commands  executed  by  supportShow  are  intended  for  support  use  only.  These 
commands  are  not  intended  for  end-users. 


Table  31    supportShow  command  groups 


Command  group 

Fabric  OS  v3.2.0 

Fabric  OS  v4.4.0 

OS 

mqshow 
i 

memShow 
mallocshow 
f astcheckheap 

mii-tool  -vv 

/usr/bin/du  -xh  /  |  /bin/sort: 
/bin/ ps  -elfh 
/bin/ echo  /bin/ rpm  -qa 
/bin/cat  /var/log/dmesg 
/bin/cat  /etc/fstab 
/bin/cat  /etc/ mtab 
printing  proc  entries. 

exception 

f aultshow 
traceshow 
err Dump 

errdump  -a/-p 
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Table  31    supportshow  command  groups  (continued) 


WUI III IIUI  lU  UIMUU 

Fnhrir        v*^  7  0 

Fnhrir        v4  4  f) 
ruwi  II.  v^*7  v*T.*T.\/ 

port 

portShow 

diagShow 

portregshow 

portShow 

ports true tshow 

portloginshow 

bloomdatashow 

portregshow 

portRouteShow 

portRouteShow 

portsemshow 

hi  1  o  oitis  ein  s  h.  0  w 

semashow  1 

tabric 

f abricShow 

f abricShow 

islShow 

islShow 

trunkShow 

trunkShow 

topologyShow 

topologyShow 

f ashow 

f abStateShow 

qlshow 

rabSwitchShow 

cf gShow 

f abStatsShow 

f abStatsShow 

f abPortShow 

f  ab  1  o  gdump 

f spf Show 

f cplogshow 

zone-stateshow 

portzoneshow 

portCamShow 

cf gSize 

cf gShow 

rcssiushow 

rcsmf  oshow 

rcsregistryshow 

services 

nsShow 

f  ditiiCacheShow 

nsAllShow 

f dmiShow 

ns  camShow 

nsShow 

llor\±J-OIiOW 

nscamShow 

security 

secModeShow 

secModeShow 

secPolicyDuiup 

s  ec  Po  1  i  cyDuitip 

sec Stats Show 

sec Stats Show 

sec Fabric Show 

sec Fabric Show 

networl< 

ipAddrShow 

/sbin/bootenv 

if show 

/sbin/sin 

ipstatshow 

/bin/df 

udpstatshow 

/sbin/ ifconf ig 

tcpstatshow 

/sbin/route 

inetstatshow 

/bin /hostname 

mbuf show 

arpshow 

routeshow 

routes tat show 

ho St show 

J-  c;  J.(ULlllippi.  J.11  L- 

i557dump 

f eiiteraterf drings 

portlog 

portLogDump  (no  parameters) 

portLogDump 

portLogDump  0,  1 
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Table  31    supportshow  command  groups  (continued) 


^uiiiiiiuiiu  uruup 

system 

version 

my  Id 

upTime 

version 

switchShow 

f irmwareShow 

temp Show 

upTime 

psShow 

switchStatusShow 

licenseShow 

switchShow 

diagShow 

haDump 

portFlagsShow 

tempShow 

port Err Show 

sensorShow 

portCf gShow 

psShow 

conf igShow 

f anShow 

licenseShow 

portFlagsShow 

portCf gShow 

sfpShow 

portErrShow 

fwSamShow 

agtCrgShow 

slotShow 

chassisShow 

switchStatusPolicyShow 

fwAlarmsFilterShow 

timeout 

historyShow 

con  f  igShow 

extend 

blooml is tdi splay 

ptbuf show 

bloomf detshow 

ptcreditshow 

b 1 o omr amdump 

ptDataShow 

ptPhantomShow 

ptPropShow 

ptStatsShow 

filter 

f iltershow 

f ilterportshow 

perfmon 

ps_dump 

ps_dump  -a  -n  port# 
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Proc  entry  information  displayed 

The  OS  command  group  prints  a  number  of  proc  entries.  Table  32  displays  example  proc  entry 
information. 


Table  32   proc  entry  information  displayed 


Pim^  ntcnln\i  ^nmmnnn 

rruw  uibpiuy  cuiiiiiiuiiu 

rruw  cAuiiipic  uibpiuy 

/proc/ cmdline 

/proc/ cmdline 

quiet 

/proc/cpuinf 0 

/proc/cpuinf o 

cpu  :  405GP 

clock  :  200MHz 

revision  :   1.69    (pvr  4011  0145) 

bogomips   :  199.47 

machine   :  Brocade  Silkworm 

plb  bus  clock  :  lOOMHz 

pel  bus  clock  :  33MHz 

/proc/devices 

/proc/devices 

Character  devices: 

1  mem 

2  pty 

3  ttyp 

4  ttyS 

5  cua 

7  vcs 

10  misc 

RQ    -1  9n 

90  mtd 

128  ptm 

136  pts 

162  raw 

245  swd 

246  ham 

9/17     j=  „ 

24o  tc-switch 

24y  tapsys 

ZOU    LSS  KC 

251  tss_uata 

zoz  LSS  ^mymc 

253  portlog 

Z34  piatzrorm 

Block  devices : 

1  ramdisk 

3  ideO 

7  loop 

/proc/ f  ilesysteius 

/proc/ f ilesystems 

nodev  rootfs 

nodev  bdev 

nodev  proc 

nodev  sockfs 

nodev  tmpfs 

nodev  shm 

nodev  pipefs 

ext2 

nodev  ramfs 

nodev  nfs 

nodev  devpts 

xf  s 

nodev  dfs 
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Table  32   proc  entry  information  displayed  (continued) 


Proc  dl^Dlav  command 

Proc  example  display 

/proc / interrupts 

/proc /interrupts 

CPUO 

0: 

0 

IBM  UIC  Level  serial 

1 : 

591  IBM  UIC  Level  serial 

2  : 

2696197  IBM  UIC  Level  IBM  OCP  IIC 

10 

0    IBM  UIC  Level   OCP  EMAC  MAL  SERR 

11 

1512   IBM  UIC  Level  OCP  EMAC  TX  FOB 

12 

343  895   IBM  UIC  Level  OCP  EMAC  RX  FOB 

13 

0    IBM  UIC  Level   OCP  EMAC  TX  DE 

14 

0    IBM  UIC  Level   OCP  EMAC  RX  DE 

26 

52017  IBM  UIC  Level  bloom 

30 

1060300  IBM  UIC  Level  ideO 

FIT: 

0 

PIT: 

15879069 

BAD: 

0 

/proc/meminf o 

/proc/meminf o 

total:  used:   free:  shared:  buffers:  cached: 

Mem: 

129740800   97079296  32661504   0  118784  45764608 

Swap 

0  0  0 

MemTotal:   126700  kB 

MemFree:   31896  kB 

MemShared:   0  kB 

Buffers:   116  kB 

Cached:   44692  kB 

SwapCached:   0  kB 

Active:   23464  kB 

Inactive:   49472  kB 

HighTotal :   0  kB 

HighFree:   0  kB 

LowTotal:   126700  kB 

LowFree:   31896  kB 

SwapTotal :   0  kB 

SwapFree:  0  kB 

/proc /modules 

/proc/modules 

dubby-module  582614  2 

chubby-module  3128618  126  [dubby-module] 

dfs  5458  1  [dubby-module] 

consolelog-module  8539  0  (unused) 

panicdump-module  15279  0  [chubby-module 

consolelog-module] 

xf snotif icationhandler  4858  0  (unused) 

/proc /mounts 

/proc/mounts 

rootfs  /  rootfs  rw  0  0 

dev/hdal  /  xfs  rw,noatime  0  0 

/proc  /proc  proc  rw  0  0 

none 

/dev/pts  devpts  rw  0  0 

none 

/tmp  ramfs  rw  0  0 

/dev/hda2  /mnt  xfs  rw,noatime  0  0 

/diag  /diag  dfs  rw  0  0 

/proc/mtd 

/proc/mtd 

dev: 

size  erasesize  name 

mtdO 

00010000  00010000   "boot  environment" 

mtdl 

00070000  00010000   "boot  prom" 

mtd2 

01000000  00040000   "Entire  user  flash" 

mtd3 

00400000  00040000   "kernel  and  initrd  (1)" 

mtd4 

00400000  00040000   "kernel  and  initrd  (2)" 

mtd5 

00400000  00040000   "log  data  (1)" 

mtd6 

00400000  00040000   "log  data  (2)" 

/iTrnr'  /T^Ptyt  i  t  "i  nn^ 

/   ^  -i-  ^  • —  /         U.  J_   1  LI  L  V^l  i.  k3> 

/proc /partitions 

major  minor  #blocks  name 

3  0  250880  hda 

3  1  124912  hdal 

3  2  124928  hda2 
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Table  32   proc  entry  information  displayed  (continued) 


Proc  display  command 

Proc  example  display 

/proc/pci 

/proc/pci 

PCI  devices  found: 

Bus  0,   device  0,    function  0: 

Host  bridge:   IBM  405GP  PLB  to  PCI  Bridge   (rev  1) . 

Master  Capable.  LatencY=7 . 

Pretetcnable  32  bit  memory  at  0x0    [0x7frfrtff J  . 

Bus  0,   device  4,    function  0: 

IDE  interface:   CMD  Technology  Inc  PCI0549    (rev  2)  . 

IRQ  30. 

Master  Capable.   Latency=64.  Min  Gnt=2.Max  Lat=4 . 

I/O  at  0x1008    [OxlOOf] . 

I/O  at  0x1000  [0x1003]. 

I/O  at  0x2000    [0x2007] . 

I/O  at   0x3000    [0x3003] . 

I/O  at  0x4000    [Ox400f ] . 

Bus  0 /   device  6 ,    function  0 : 

Non-VGA  unclassified  device:   Brocade  Communications 

Systems,    Inc.   Bloom  switch   (rev  0). 

IRQ  26. 

--<output  truncated>-- 

/proc/slabinf o 

/proc/ slabinfo 

slabinfo  -  version:  1.1 

Kinem_cache  /4  102  112  3  3  1 

ip_mrt_cache  0  0  96  0  0  1 

tcp_tw_buc]<;et  24096111 

tcp_bind_buc]<;et  5  113  32  1  1  1 

tcp_open_request  0  59  64  0  1  1 

inet_peer_cache  1  59  64  1  1  1 

ip_fib_hash  11  113  32  1  1  1 

ip_dst_cache  65  168  160  7  7  1 

arp_cache  2  30  12 8111 

bllcdev  requests  12  8  160  96  4  4  1 

xfs_chashlist  193  404  16  2  2  1 

xrs  111    ZUU41:    jDOo    IDZ    loD    zlo  1 

xfs_ifor]c  0  0  56  0  0  1 

xfs_efi_item  0  12  328  Oil 

xfs_efd_item  0  12  328  0  1  1 

--<output  truncated>-- 

/proc/stat 

/proc/stat 

cpu  184683  47107  88647  15558673 

cpuO  184583  47107  88647  15558673 

page  54635  71305 

swap  0  0 

intr  4154525  0  591  2696197  00000000  1520  343900 

UUUUUUUUUUUUU    jzUl/    U    U    U    lUoUoUU  U 

disli_io:    (3,0) : (61121,5352,115463,55769,944835) 

ctxt  44089966 

btime  1048729603 

processes  17684 

/ proc / tty/ drivers 

/proc/ tty /drivers 

serial  /dev/cua  5  64-65  serial : callout 

serial  /dev/ttyS  4  64-65  serial 

pty_slave  /dev/pts  136  0-255  pty: slave 

pty_master  /dev/ptm  128  0-255  pty:master 

pty_slave  /dev/ttyp  3  0-255  pty: slave 

T)t~v  TTii=ic^tpr"    /dp\7'/r~)tv   9    0-955   nt~  v  ■  rrir^    t~  pr 

/dev/vc/0  /dev/vc/0  4  0  system : vtmaster 

/dev/ptmx  /dev/ptmx  5  2  system 

/dev/console  /dev/console  5  1  system: console 

/dev/tty  /dev/tty  5  0  system: /dev/tty 
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Table  32   proc  entry  information  displayed  (continued) 


Proc  display  command 

Proc  example  display 

/proc /uptime 

/proc /uptime 
158791.21  155710.77 

/proc /vers ion 

/proc /version 

Linux  version  2.4.19    (swrelSsierra)    (gcc  version 
2.95.3  20010112    (prerelease))    #1  Wed  Mar  26  00:04:35 
PST  2003 
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Glossary 


8b/10b  encoding 
address  identifier 
AL_PA 
ALJIME 
alias 


alias  address 
identifier 

alias  AL  PA 


alias  server 
ANSI 

arbitrated  loop 

arbitration 
area  number 


ARP 

ARR 

ASD 

ASIC 
ATM 

authentication 


An  encoding  scheme  that  converts  each  8-bit  byte  into  10  bits.  Used  to  balance  Is  and  Os  in 
high-speed  transports. 

A  24-bit  or  8-bit  value  used  to  identify  the  source  or  destination  of  a  frame.  See  also  S  ID 
and  DJD. 

Arbitrated-loop  physical  address.  A  unique  8-bit  value  assigned  during  loop  initialization  to  a 
port  in  an  arbitrated  loop. 

Arbitrated-loop  timeout  value.  Tv/ice  the  amount  of  time  it  would  take  for  a  transmission  v/ord 
to  propagate  around  a  worst-case  loop.  The  default  value  is  15  milliseconds  (ms). 

A  logical  grouping  of  elements  in  a  fabric.  An  alias  is  a  collection  of  port  numbers  and 
connected  devices,  used  to  simplify  the  entry  of  port  numbers  and  WWNs  when  creating 
zones. 

An  address  identifier  recognized  by  a  port  in  addition  to  its  standard  identifier.  An  alias 
address  identifier  can  be  shared  by  multiple  ports.  See  also  alias. 

An  AL_PA  value  recognized  by  an  L  Port  in  addition  to  the  AL  PA  assigned  to  the  port.  See 
also  AL_PA. 

A  fabric  software  facility  that  supports  multicast  group  management. 
American  National  Standards  Institute. 

A  shared  100-Mb/sec  Fibre  Channel  transport  structured  as  a  loop.  Can  support  up  to  126 
devices  and  one  fabric  attachment.  See  also  topology. 

A  method  of  gaining  orderly  access  to  a  shared-loop  topology. 

In  HP  Fabric  OS  v4.x  and  above,  ports  on  a  switch  are  assigned  a  logical  area  number.  Port 
area  numbers  can  be  viewed  by  entering  the  switchShow  command.  They  are  used  to 
define  the  operative  port  for  many  Fabric  OS  commands:  for  example,  area  numbers  can  be 
used  to  define  the  ports  within  an  alias  or  zone. 

Address  Resolution  Protocol.  A  TCP/IP  function  for  associating  an  IP  address  with  a  link-level 
address. 

Asynchronous  response  router.  Refers  to  Management  Server  GS_Subtype  Code  E4,  which 
appears  in  portLogDump  command  output. 

Alias  server  daemon.  Used  for  managing  multicast  groups  by  supporting  the  create,  add, 
remove,  and  destroy  functions. 

Application-specific  integrated  circuit. 

Asynchronous  Transfer  Mode.  A  transport  used  for  transmitting  data  over  LANs  or  WANs  that 
transmit  fixed-length  units  of  data.  Provides  any-to-any  connectivity  and  allows  nodes  to 
transmit  simultaneously. 

The  process  of  verifying  that  an  entity  in  a  fabric  (such  as  a  switch)  is  what  it  claims  to  be.  See 
a/so  digital  certificate,  switch-to-switch  authentication. 
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autocommit 

autoreboot 
AWJOV 

backbone  fabric 

backup  FCS  switch 

BB  fabric 

BB_Creclit 

beacon 


beginning  running 
disparity 

BER 


BISR 
BIST 

bit  synchroniza-tion 
Bloom 

boot  code 

boot  flash 
broadcast 


buffer-to-buffer  flow 
control 

bypass  circuitry 


CA 


A  feature  of  the  f  irmwareDownload  command.  Enabled  by  default,  autocommit  commits 
new  firmware  to  both  partitions  of  a  control  processor. 

Refers  to  the  -b  option  of  the  f  irmwareDownload  command.  Enabled  by  default. 

Arbitration  wait  timeout  value.  The  minimum  time  an  arbitrating  L_Port  waits  for  a  response 
before  beginning  loop  initialization. 

An  optional  capability  that  enables  scalable  meta-SANs  by  allowing  the  networking  of 
multiple  PC  routers,  which  connect  to  the  backbone  fabric  via  EB_Port  interfaces. 

Relates  to  the  HP  Secure  Fabric  OS  feature.  The  backup  fabric  configuration  server  serves  as  a 
backup  in  case  the  primary  FCS  switch  fails.  See  also  FCS  switch,  primary  FCS  switch. 

A  backbone  fabric  that  connects  PC  Routers.  The  PC  Routers  communicate  over  the  backbone 
fabric  using  PCRP  (Fibre  Channel  Router  Protocol). 

Buffer-to-buffer  credit.  The  number  of  frames  that  can  be  transmitted  to  a  directly  connected 
recipient  or  within  an  arbitrated  loop.  Determined  by  the  number  of  receive  buffers  available. 
See  also  buffer-to-buffer  flow  control,  EE_Credit. 

A  tool  in  which  all  of  the  port  LEDs  on  a  switch  are  set  to  flash  from  one  side  of  the  switch  to 
the  other,  to  enable  identification  of  an  individual  switch  in  a  large  fabric.  A  switch  can  be  set 
to  beacon  by  a  CLI  command  or  through  HP  Advanced  Web  Tools. 

The  disparity  at  the  transmitter  or  receiver  when  the  special  character  associated  with  an 
ordered  set  is  encoded  or  decoded.  See  also  disparity. 

Bit  error  rate.  The  rate  at  which  bits  are  expected  to  be  received  in  error.  Expressed  as  the  ratio 
of  error  bits  to  total  bits  transmitted.  See  also  error. 

Built-in  self-repair. 

Built-in  self-test. 

The  condition  in  which  a  receiver  is  delivering  retimed  serial  data  at  the  required  bit  error  rate. 

The  code  name  given  to  the  third-generation  HP  Fabric  ASIC.  This  ASIC  is  used  in  HP 
StorageWorks  2  GB  switches  and  beyond. 

Software  that  initialized  the  system  environment  during  the  early  phase  of  the  boot-up  process. 
For  example,  boot  code  might  determine  the  amount  of  available  memory  and  how  to  access 
it. 

Flash  (temporary)  memory  that  stores  the  boot  code  and  boot. 

The  transmission  of  data  from  a  single  source  to  all  devices  in  the  fabric,  regardless  of  zoning. 
See  also  multicast,  unicast. 

Management  of  the  frame  transmission  rate  in  either  a  point-to-point  topology  or  in  an 
arbitrated  loop.  See  also  BB_Credit. 

Circuits  that  automatically  remove  a  device  from  the  data  path  when  valid  signals  are 
dropped. 

Certificate  authority.  A  trusted  organization  that  issues  digital  certificates.  See  also  digital 
certificate. 


CAM 


Content-addressable  memory. 
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cascade 

CDR 
CE 
CFG 
CFN 

chassis 
CIM 

Class  1  service 

Class  2  service 
Class  3  service 

Class  4  service 
Class  6  service 
Class  F  service 

class  of  service 
CLS 

CM 

CMA 

CMBISR 

CMT 

comma 

community  (SNMP) 
compact  flash 


Two  or  more  interconnected  Fibre  Channel  switches.  HP  StorageWorks  1  GB/s  switches  and 
later  switches  can  be  cascaded  up  to  239  switches,  with  a  recommended  maximum  of  seven 
hop  interswitch  links  (no  path  longer  than  eight  switches).  See  also  fabric,  ISL. 

Clock  and  data  recovery  circuitry. 

Conformite  Europeenne. 

Configuration. 

Change  fabric  name.  Refers  to  an  ELS  field  that  appears  in  portLogDump  command  output. 

The  metal  frame  in  which  the  switch  and  switch  components  are  mounted. 

Common  Information  Model.  A  management  structure  enabling  disparate  resources  to  be 
managed  by  a  common  application. 

The  class  of  frame-switching  service  for  a  dedicated  connection  between  two  communicating 
ports  (also  called  connection-oriented  service).  Includes  acknowledgement  of  frame  delivery  or 
nondelivery. 

A  connectionless  class  of  frame-switching  service  that  includes  acknowledgement  of  frame 
delivery  or  nondelivery. 

A  connectionless  class  of  frame-switching  service  that  does  not  include  acknowledgement  of 
frame  delivery  or  nondelivery.  Can  be  used  to  provide  a  multicast  connection  between  the 
frame  originator  and  recipients,  with  acknowledgement  of  frame  delivery  or  nondelivery. 

A  connection-oriented  service  that  allows  fractional  parts  of  the  bandwidth  to  be  used  in  a 
virtual  circuit. 

A  connection-oriented  multicast  service  geared  toward  video  broadcasts  between  a  central 
server  and  clients. 

The  class  of  frame-switching  service  for  a  direct  connection  between  two  switches,  allowing 
communication  of  control  traffic  between  the  E_Ports.  Includes  acknowledgement  of  data 
delivery  or  nondelivery. 

A  specified  set  of  delivery  characteristics  and  attributes  for  frame  delivery. 

Close  primitive  signal.  Used  only  in  an  arbitrated  loop.  Sent  by  an  L_Port  that  is  currently 
communicating  in  the  loop,  to  close  communication  with  another  L  Port. 

Central  memory. 

Central  memory  architecture.  An  architecture  centralizing  memory  usage  in  switches. 
Central  memory  built-in  self-repair. 
Central  memory  test. 

A  unique  pattern  (either  1 100000  or  001 1111)  used  in  8b/10b  encoding  to  specify 
character  alignment  within  a  data  stream. 

A  relationship  between  a  group  of  SNMP  managers  and  an  SNMP  agent,  in  which 
authentication,  access  control,  and  proxy  characteristics  are  defined.  See  also  SNMP. 

Flash  (temporary)  memory  that  is  used  in  a  manner  similar  to  hard  disk  storage.  It  is  connected 
to  a  bridging  component  that  connects  to  the  PCI  bus  of  the  processor.  Not  visible  within  the 
processor's  memory  space. 
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configuration 


congestion 

connection  initiator 

connection  recipient 

controller 

COS 
CP 
CRC 
credit 

cut-through 

D_ID 

DAS 

data  word 
DCC 

dedicated  simplex 


defined  zone 
configuration 

deskew 


DHCP 
DHCPD 


(1 )  A  set  of  parameters  that  can  be  modified  to  fine-tune  the  operation  of  a  switch.  Use  the 
conf  igShow  command  to  view  the  current  configuration  of  your  switch. 

2)  In  HP  Zoning,  a  zoning  element  that  contains  a  set  of  zones.  The  Configuration  is  the 
highest-level  zoning  element  and  is  used  to  enable  or  disable  a  set  of  zones  on  the  fabric.  See 
also  zone  configuration. 

The  realization  of  the  potential  of  oversubscription.  A  congested  link  is  one  on  which  multiple 
devices  are  contending  for  bandwidth. 

A  port  that  has  originated  a  Class  1  dedicated  connection  and  received  a  response  from  the 
recipient. 

A  port  that  has  received  a  Class  1  dedicated  connection  request  and  transmitted  a  response  to 
the  originator. 

A  computer  module  that  interprets  signals  between  a  host  and  a  peripheral  device.  The 
controller  typically  is  part  of  the  peripheral  device. 

Class  of  service. 

Control  processor. 

Cyclic  redundancy  check.  A  transmission  error  check  that  is  included  in  every  data  frame. 

As  it  applies  to  Fibre  Channel  technology,  the  number  of  receive  buffers  available  to  transmit 
frames  between  ports.  See  also  BB_Credit,  EE_Credit. 

A  switching  technique  that  allows  the  route  for  a  frame  to  be  selected  as  soon  as  the 
destination  address  is  received.  See  also  route. 

Destination  identifier.  A  3-byte  field  in  the  frame  header,  used  to  indicate  the  address  identifier 
of  the  N_Port  to  which  the  frame  is  headed. 

Direct  attached  storage. 

A  type  of  transmission  word  that  occurs  within  frames.  The  frame  header,  data  field,  and  CRC 
all  consist  of  data  words.  See  also  frame,  ordered  set,  transmission  word. 

Direct  cable  connection.  DCC  does  not  require  network  interface  cards  (NICs),  making  it 
relatively  inexpensive  and  simple;  however,  it  provides  a  limited  connection  between  two  PCs, 
and  the  data  transfer  rate  is  slower  than  with  a  true  LAN. 

A  connection  method  that  permits  a  single  N  Port  to  simultaneously  initiate  a  session  with  one 
N_Port  as  an  initiator  and  have  a  separate  Class  1  connection  to  another  N  Port  as  a 
recipient. 

The  set  of  all  zone  objects  defined  in  the  fabric.  Can  include  multiple  zone  configurations.  See 
also  enabled  zone  configuration,  zone  configuration. 

Related  to  the  HP  Trunking  feature.  The  time  difference  between  traffic  traveling  over  each  ISL 
other  than  the  shortest  ISL  in  the  group  and  traffic  traveling  over  that  shortest  ISL.  The  deskew 
number  corresponds  to  nanoseconds  divided  by  1 0.  The  firmware  automatically  sets  the 
minimum  deskew  value  of  the  shortest  ISL  to  1 5. 

Dynamic  Host  Configuration  Protocol. 

Dynamic  Host  Configuration  Protocol  daemon. 


762  Glossary 


digital  certificate 

disparity 

DLS 
DMTF 

domain  controller 
domain  ID 

DTE 

DWDM 
E_D_TOV 

E_Port 
ECCN 

edge  fabric 
EE_Credit 

EIA  rack 

ELP 

ELS 

EM 

embedded  port 
EMI 

emulex 

enabled  zone 
configuration 


An  electronic  document  issued  by  a  CA  (certificate  authority)  to  an  entity,  containing  the 
public  key  and  identity  of  the  entity.  Entities  in  a  secure  fabric  are  authenticated  based  on 
these  certificates.  See  also  authentication,  CA,  public  key. 

The  proportion  of  Is  and  Os  in  an  encoded  character.  Neutral  disparity  means  an  equal 
number  of  each,  positive  disparity  means  a  majority  of  Is,  and  negative  disparity  means  a 
majority  of  Os. 

Dynamic  load-sharing.  Dynamic  distribution  of  traffic  over  available  paths.  Allov/s  for 
recomputing  of  routes  when  an  Fx  Port  or  E  Port  changes  status. 

Distributed  Management  Task  Force. 

A  domain  controller  or  embedded  port  communicates  v/ith  and  gets  updates  from  other 
sv/itches'  embedded  ports.  The  well-knov/n  address  is  fffcdd,  where  dd  =  domain  number). 

A  unique  identifier  for  all  switches  in  a  fabric,  used  in  routing  frames.  Usually  automatically 
assigned  by  the  principal  switch  but  can  be  assigned  manually.  The  domain  ID  for  a  HP 
StorageWorks  switch  can  be  any  integer  between  1  and  239. 

Data  terminal  equipment.  Usually  refers  to  a  terminal. 

Dense  wave  division  multiplexing.  Allows  more  wavelengths  to  use  the  same  fiber.  See  WDM. 

Error-detect  timeout  value.  The  minimum  amount  of  time  a  target  waits  for  a  sequence  to 
complete  before  initiating  recovery.  Can  also  be  defined  as  the  maximum  time  allowed  for  a 
round-trip  transmission  before  an  error  is  declared.  See  also  R_A_TOV,  RR_TOV. 

Expansion  port.  A  standard  Fibre  Channel  mechanism  that  enables  switches  to  network  with 
each  other,  creating  an  ISL.  See  also  ISL. 

Export  classification  control  number.  A  government  classification  of  encryption.  For  example, 
SSH  is  in  the  high-encryption  category  (number  5x02)  and  therefore  has  certain  restrictions 
regarding  its  transfer. 

A  Fibre  Channel  fabric  connected  to  an  FC  router  via  an  EX_Port  (where  hosts  and  storage  are 
attached  in  a  meta-SAN). 

End-to-end  credit.  The  number  of  receive  buffers  allocated  by  a  recipient  port  to  an  originating 
port.  Used  by  Class  1  and  2  services  to  manage  frame  exchange  across  the  fabric,  between 
source  and  destination.  See  also  BB_Credit,  end-to-end  flow  control. 

A  storage  rack  that  meets  the  standards  set  by  the  Electronics  Industry  Association  (EIA). 

Exchange  link  parameters. 

Extended  link  service.  ELSs  are  sent  to  the  destination  N  Port  to  perform  the  requested  function 
or  service.  ELS  is  a  Fibre  Channel  standard  that  is  sometimes  referred  to  as  "Fibre  Channel 
Physical  (FC_PH)  ELS." 

Environmental  monitor.  Monitors  FRUs  and  reports  failures. 

An  embedded  port  (or  domain  controller)  communicates  and  get  updates  from  other  switches' 
embedded  ports.  The  well-known  address  is  fffcdd,  where  dd  =  domain  number. 

Electromagnetic  interference. 

A  brand  of  host  bus  adapter. 

The  currently  enabled  configuration  of  zones.  Only  one  configuration  can  be  enabled  at  a 
time.  See  also  defined  zone  configuration,  zone  configuration. 
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Governs  flow  of  Class  1  and  2  frames  between  N_Ports.  See  also  EE  Credit. 

The  basic  HP  software  license  that  allows  one  E_Port  per  switch. 

End  of  frame.  A  group  of  ordered  sets  used  to  mark  the  end  of  a  frame. 

As  it  applies  to  the  Fibre  Channel  industry,  a  missing  or  corrupted  frame,  timeout,  loss  of 
synchronization,  or  loss  of  signal  (link  errors).  See  also  loop  failure. 

Event  management  database.  Delivers  FDMI-related  events. 

A  type  of  E  Port  that  connects  an  PC  router  to  an  edge  fabric.  EX_Ports  limit  the  scope  of 
fabric  services  scope  but  provide  device  connectivity  using  FC-NAT. 

The  highest-level  Fibre  Channel  mechanism  used  for  communication  between  N_Ports. 
Composed  of  one  or  more  related  sequences,  it  can  work  in  either  one  or  both  directions. 

A  device  that  has  been  mapped  between  fabrics  (a  host  or  storage  port  in  one  edge  fabric 
can  be  exported  to  any  other  fabric  by  using  LSAN  zoning). 

Fabric  port  busy  frame.  A  frame  issued  by  the  fabric  to  indicate  that  a  frame  cannot  be 
delivered  because  the  fabric  or  destination  N  Port  is  busy. 

Fabric  port.  A  port  that  is  able  to  transmit  under  fabric  protocol  and  interface  over  links.  Can 
be  used  to  connect  an  N  Port  to  a  switch.  See  also  FL  Port,  Fx  Port. 

Fabric  port  reject  frame.  A  frame  issued  by  the  fabric  to  indicate  that  delivery  of  a  frame  is 
being  denied,  perhaps  because  a  class  is  not  supported,  there  is  an  invalid  header,  or  no 
N_Port  is  available. 

A  collection  of  Fibre  Channel  switches  and  devices,  such  as  hosts  and  storage.  Also  referred  to 
as  a  switched  fabric.  See  also  cascade,  SAN,  topology. 

A  device  that  enables  fabric-based  storage  applications  such  as  mirroring,  data  migration, 
snapshots,  and  virtual  tape.  The  HP  StorageWorks  Fabric  Application  Platform  can  run  in  a 
central  location,  process  data  at  wire-speed,  and  reside  in  existing  data  paths. 

An  optionally  licensed  HP  software.  Fabric  Manager  is  a  GUI  that  allows  for  fabric-wide 
administration  and  management.  Switches  can  be  treated  as  groups,  and  actions  such  as 
firmware  downloads  can  be  performed  simultaneously. 

One  of  two  possible  modes  for  an  L_Port,  in  which  the  L_Port  is  connected  to  another  port  that 
is  not  loop  capable,  using  fabric  protocol. 

The  unique  identifier  assigned  to  a  fabric  and  communicated  during  login  and  port  discovery. 

The  number  of  ports  available  for  connection  by  nodes  in  a  fabric. 

Codes  that  describe  the  communication  to  and  from  any  well-known  address. 

The  arrangement  of  switches  that  form  a  fabric. 

An  optionally  licensed  HP  software.  Fabric  Watch  can  be  accessed  through  either  the 
command  line  or  Advanced  Web  Tools,  and  it  provides  the  ability  to  set  thresholds  for 
monitoring  fabric  conditions. 

Describes  the  Core  Switch  2/64  process  of  one  CP  passing  active  status  to  another  CP.  A 
failover  is  nondisruptive. 
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FAN  Fabric  address  notification.  Retains  the  AL_PA  and  fabric  address  wfien  a  loop  reinitializes,  if 

the  switch  supports  FAN. 

fan-in  The  ratio  of  hosts  to  storage  devices;  the  view  of  the  SAN  from  the  storage  port's  perspective. 

fan-out  The  ratio  of  storage  devices  to  hosts;  the  view  of  the  SAN  from  the  host  port's  perspective. 

FC-0  Lowest  layer  of  Fibre  Channel  transport.  Represents  physical  media. 

FC-1  Layer  of  Fibre  Channel  transport  that  contains  the  8b/l  Ob  encoding  scheme. 

FC-2  Layer  of  Fibre  Channel  transport  that  handles  framing  and  protocol,  frame  format, 

sequence/exchange  management,  and  ordered  set  usage. 

FC-3  Layer  of  Fibre  Channel  transport  that  contains  common  services  used  by  multiple  N_Ports  in  a 

node. 

FC-4  Layer  of  Fibre  Channel  transport  that  handles  standards  and  profiles  for  mapping  upper-level 

protocols  such  as  SCSI  and  IP  onto  the  Fibre  Channel  Protocol. 

FC-AL-3  The  Fibre  Channel  arbitrated-loop  standard  defined  by  ANSI.  Defined  on  top  of  the  FC-PH 

standards. 

FC-AV  Fibre  Channel  audio  visual. 

FC-CT  Fibre  Channel  common  transport. 

FC-FG  Fibre  Channel  generic  requirements. 

FC-FLA  The  Fibre  Channel  fabric  loop-attach  standard  defined  by  ANSI. 

FC-FS  Fibre  Channel  framing  and  signaling. 

FC-GS  Fibre  Channel  generic  services. 

FC-GS-2  Fibre  Channel  generic  services,  second  generation. 

FC-GS-3  Fibre  Channel  Generic  Services,  third  generation. 

FCIP  Fibre  Channel  over  IP. 

FC-NAT  Fibre  Channel  network  address  translation. 

FC-PH  The  Fibre  Channel  physical  and  signaling  standard  for  FC-0,  FC-1,  and  FC-2  layers  of  the 

Fibre  Channel  Protocol.  Indicates  signaling  used  for  cable  plants,  media  types,  and 
transmission  speeds. 

FC-PH-2  Fibre  Channel  Physical  Interface,  second  generation. 

FC-PH-3  Fibre  Channel  Physical  Interface,  third  generation. 

FC-PI  Fibre  Channel  Physical  Interface  standard,  defined  by  ANSI. 

FC-PLDA  The  Fibre  Channel  Private  Loop  Direct  Attach  standard  defined  by  ANSI.  Applies  to  the 

operation  of  peripheral  devices  on  a  private  loop. 

FC_SB  Fibre  Channel  single  bytes. 

FC_VI  Fibre  Channel  virtual  interface. 

FCA  Flow-control  acknowledgement  (DLSW). 


Fabric  OS  5.0.0  command  reference  guide  765 


Fibre  Channel  Industry  Association.  An  international  organization  of  Fibre  Channel  industry 
professionals.  Provides  oversight  of  ANSI  and  industry-developed  standards,  among  other 
tasks. 

The  HP  Multiprotocol  SAN  Routing  Service  that  enables  SANs  to  span  longer  distances  than 
could  be  supported  with  native  Fibre  Channel  links.  FCIP  is  a  TCP/IP-based  tunneling  protocol 
that  allov/s  the  transparent  interconnection  of  geographically  distributed  SAN  islands  through 
an  IP-based  netv^ork. 

Fibre  Channel  Loop  Community. 

Fibre  Channel  Protocol.  Mapping  of  protocols  onto  the  Fibre  Channel  standard  protocols.  For 
example,  SCSI  FCP  maps  SCSI-3  onto  Fibre  Channel. 

Fibre  Channel  Router  Protocol.  A  protocol  that  enables  LSAN  sv/itches  to  perform  routing 
between  different  edge  fabrics,  optionally  across  a  backbone  fabric. 

Fibre  Channel  Routing  Service.  The  HP  Multiprotocol  SAN  Routing  Service  that  extends 
hierarchical  networking  capabilities  to  Fibre  Channel  fabrics.  Sometimes  called  "FC-to-FC 
routing,"  FCRS  enables  devices  located  on  separate  fabrics  to  communicate  without  merging 
the  fabrics.  It  also  enables  the  creation  of  LSANs. 

Fibre  Channel  switch. 

Relates  to  the  HP  Secure  Fabric  OS  feature.  One  or  more  designated  switches  that  store  and 
manage  security  parameters  and  configuration  data  for  all  switches  in  the  fabric.  They  also  act 
as  a  set  of  backup  switches  to  the  primary  FCS  switch.  See  also  backbone  fabric,  primary  FCS 
switch. 

The  second-generation  Fibre  Channel  Switch  Fabric  standard  defined  by  ANSI.  Specifies  tools 
and  algorithms  for  the  interconnection  and  initialization  of  Fibre  Channel  switches  to  create  a 
multiswitch  Fibre  Channel  fabric. 

Fibre  Distributed  Data  Interface.  An  ANSI  architecture  for  a  metropolitan  area  network  (MAN); 
a  network  based  on  the  use  of  fiber-optic  cable  to  transmit  data  at  1 00  Mb/sec. 

Fabric-Device  Management  Interface.  FDMI  is  a  database  service  provided  by  the  fabric  for 
Nx  Ports.  The  primary  use  is  by  HBA  devices  that  register  information  about  themselves  and 
their  ports. 

Well-known  Fibre  Channel  address  for  a  Class  6  multicast  server. 
Well-known  Fibre  Channel  address  for  a  clock  synchronization  server. 
Well-known  Fibre  Channel  address  for  a  security  key  distribution  server. 
Well-known  Fibre  Channel  address  for  an  alias  server. 
Well-known  Fibre  Channel  address  for  a  QoS  facilitator. 
Well-known  Fibre  Channel  address  for  a  management  server. 
Well-known  Fibre  Channel  address  for  a  time  server. 
Well-known  Fibre  Channel  address  for  a  directory  server. 
Well-known  Fibre  Channel  address  for  a  fabric  controller. 
Well-known  Fibre  Channel  address  for  a  fabric  F  Port. 
Well-known  Fibre  Channel  address  for  a  broadcast  alias  ID. 


Fibre  Channel 

Fibre  Channel 
transport 

FID 

fill  word 

firmware 

firmware 
watermarking 

FL_Port 

flash 
FLOGI 

FOTP 

FPD 

FPGA 

fractional 
bandwidth 

frame 
frame  relay 

FRU 
FS 

FSP 


The  primary  protocol  used  for  building  SANs  to  transmit  data  between  servers,  switches,  and 
storage  devices.  Unlike  IP  and  Ethernet,  Fibre  Channel  was  designed  to  support  the  needs  of 
storage  devices  of  all  types.  It  is  a  high-speed,  serial,  bidirectional,  topology-independent, 
multiprotocol,  and  highly  scalable  interconnection  between  computers,  peripherals,  and 
networks. 

A  protocol  service  that  supports  communication  between  Fibre  Channel  service  providers.  See 
also  FSP. 


Fabric  ID.  Unique  identifier  of  a  fabric  in  a  meta-SAN. 

An  IDLE  or  ARB  ordered  set  that  is  transmitted  during  breaks  between  data  frames  to  keep  the 
Fibre  Channel  link  active. 

The  basic  operating  system  provided  with  the  hardware. 

A  HP  StorageWorks  switch  feature  that  prevents  an  incompatible  version  of  the  HP  Fabric  OS 
to  be  downloaded  to  the  HP  2  GB  series  switches. 

Fabric  loop  port.  A  port  that  is  able  to  transmit  under  fabric  protocol  and  also  has 
arbitrated-loop  capabilities.  Can  be  used  to  connect  an  NL  Port  to  a  switch.  See  also  F  Port, 
Fx_Port. 

Programmable  nonvolatile  RAM  (NVRAM)  memory  that  maintains  its  contents  without  power. 

Fabric  login.  The  process  by  which  an  N_Port  determines  whether  a  fabric  is  present  and,  if 
so,  exchanges  service  parameters  with  it.  See  also  PLOGI. 

Fiber  Optic  Test  Procedure.  Standards  developed  and  published  by  the  Electronic  Industries 
Association  (EIA)  under  the  EIA-RS-455  series  of  standards. 

Field-programmable  device.  Interchangeable  with  "PLD". 

Field-programmable  gate  array.  An  FPD  that  allows  high  logic  capacity. 

The  partial  use  of  a  link  to  send  data  back  and  forth,  with  a  maximum  of  254  Class  4 
connections  per  N_Port. 

The  Fibre  Channel  structure  used  to  transmit  data  between  ports.  Consists  of  a  start-of -frame 
delimiter,  header,  optional  headers,  data  payload,  cyclic  redundancy  check  (CRC),  and 
end-of-frame  delimiter.  There  are  two  types  of  frames:  link  control  frames  (transmission 
acknowledgements  and  so  forth)  and  data  frames. 

A  protocol  that  uses  logical  channels,  as  used  in  X.25.  Provides  very  little  error-checking 
ability.  Discards  frames  that  arrive  with  errors.  Allows  a  certain  level  of  bandwidth  between 
two  locations  (known  as  a  committed  information  rate:  CIR)  to  be  guaranteed  by  service 
provider.  If  CIR  is  exceeded  for  short  periods  (known  as  bursts),  the  network  accommodates 
the  extra  data,  if  spare  capacity  is  available.  Frame  relay  is  therefore  known  as  bandwidth  on 
demand. 

Field-replaceable  unit.  A  component  that  can  be  replaced  onsite. 

Fibre  Channel  service.  A  service  that  is  defined  by  Fibre  Channel  standards  and  exists  at  a 
well-known  address.  For  example,  the  Simple  Name  Server  is  a  Fibre  Channel  service.  See 
also  FSP. 

Fibre  Channel  Service  Protocol.  The  common  protocol  for  all  fabric  services,  transparent  to  the 
fabric  type  or  topology.  See  also  FS. 
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FSPF 
FSS 


FTP 
FTS 

full  fabric 


Fabric  shortest  path  first.  The  HP  routing  protocol  for  Fibre  Channel  switches. 

Fabric  OS  state  synchronization.  The  FSS  service  is  related  to  high  availability  (HA).  The 
primary  function  of  FSS  is  to  deliver  state  update  messages  from  active  components  to  their 
peer  standby  components.  FSS  determines  if  fabric  elements  are  synchronized  (and  thus  FSS 
compliant). 

File  Transfer  Protocol. 

Fiber  Transport  Services. 

The  HP  software  license  that  allows  multiple  E_Ports  on  a  switch,  making  it  possible  to  create 
multiple  ISL  links. 


full  fabric  citizenship  A  loop  device  that  has  an  entry  in  the  Simple  Name  Server, 
full  duplex 
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G_Port 

gateway 
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GUI 

HA 

half  duplex 
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Hardware 
Translative  Mode 
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header 


A  mode  of  communication  that  allows  the  same  port  to  simultaneously  transmit  and  receive 
frames.  See  also  half  duplex. 

A  fabric  port  that  can  operate  as  either  an  F  Port  or  FL  Port.  See  also  F  Port,  FL  Port. 

Generic  port.  A  port  that  can  operate  as  either  an  E_Port  or  an  F  Port.  A  port  is  defined  as  a 
G_Port  when  it  is  not  yet  connected  or  has  not  yet  assumed  a  specific  function  in  the  fabric. 

Hardware  that  connects  incompatible  networks  by  providing  translation  for  both  hardware 
and  software.  For  example,  an  ATM  gateway  can  be  used  to  connect  a  Fibre  Channel  link  to 
an  ATM  connection. 

Gigabit  interface  converter.  A  removable  serial  transceiver  module  that  allows  gigabaud 
physical-level  transport  for  Fibre  Channel  and  gigabit  Ethernet. 

Gigabits  per  second  (1,062,500,000  bits/second). 

Gigabytes  per  second  (1,062,500,000  bytes/second). 

Gigabit  Link  Module.  A  semitransparent  transceiver  that  incorporates  serializing/deserializing 
functions. 

Greenwich  Mean  Time.  An  international  time  zone.  Also  known  as  UTC. 

A  graphic  user  interface,  such  as  HP  Advanced  Web  Tools  arbitrated-loop  topology  and  HP 
Fabric  Manager. 

High  availability.  A  set  of  features  in  HP  switches  that  is  designed  to  provide  maximum 
reliability  and  nondisruptive  replacement  of  key  hardware  and  software  modules. 

A  mode  of  communication  that  allows  a  port  to  either  transmit  or  receive  frames  at  any  time 
except  simultaneously  (with  the  exception  of  link  control  frames,  which  can  be  transmitted  at 
any  time).  See  also  full  duplex. 

The  AL_PA  that  an  NL_Port  attempts  to  acquire  during  loop  initialization. 

A  method  for  achieving  address  translation.  There  are  two  hardware  translative  modes 
available  to  a  QuickLoop  enabled  switch:  Standard  Translative  Mode  and  QuickLoop  Mode. 

Host  bus  adapter.  The  interface  card  between  a  server  or  workstation  bus  and  the  Fibre 
Channel  network. 

High-capacity  PLD.  Refers  to  both  CPLDs  and  FPGAs. 

A  Fibre  Channel  frame  has  a  header  and  a  payload.  The  header  contains  control  and 
addressing  information  associated  with  the  frame. 
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The  number  of  ISLs  a  frame  must  traverse  to  get  from  its  source  to  its  destination. 

A  computer  system  that  provides  end  users  with  services  like  computation  and  storage  access. 

A  hot  sv/appable  component  can  be  replaced  under  power. 

Hypertext  Transfer  Protocol.  The  standard  TCP/IP  transfer  protocol  used  on  the  World  Wide 
Web. 

A  Fibre  Channel  wiring  concentrator  that  collapses  a  loop  topology  into  a  physical  star 
topology.  Nodes  are  automatically  added  to  the  loop  when  active  and  removed  when 
inactive. 

A  number  of  N_Ports  registered  as  a  single  AliasJD  so  that  the  fabric  can  route  a  word  to  a 
port  that  is  not  busy. 

Hardware. 

Insistent  domain  ID.  A  parameter  of  the  configure  command  in  the  HP  Fabric  OS. 

Continuous  transmission  of  an  ordered  set  over  a  Fibre  Channel  link  when  no  data  is  being 
transmitted,  to  keep  the  link  active  and  maintain  bit,  byte,  and  word  synchronization. 

Internet  Fibre  Channel  Protocol.  Supports  Fibre  Channel  Layer  4  FCP-Over-TCP/IP.  It  is  a 
gateway-to-gateway  protocol  in  which  TCP/IP  switching  and  routing  components 
enhance/ replace  Fibre  Channel  fabric. 

Interfabric  link.  A  connection  between  a  router  and  an  edge  fabric.  Architecturally,  these  can 
be  of  type  EX_Port-to-E_Port  or  EX_Port-to-EX_Port. 

Transmission  of  management  protocol  over  the  Fibre  Channel. 

A  server  or  workstation  on  a  Fibre  Channel  network  that  initiates  communications  with  storage 
devices.  See  also  target. 

Sets  the  domain  ID  of  a  switch  as  insistent,  so  that  it  remains  the  same  over  reboots,  power 
cycles,  failovers,  and  fabric  reconfigurations. 

The  fabric  created  by  a  HP  SAN  Switch  Integrated/64,  consisting  of  six  HP  1  GB  switches 
cabled  together  and  configured  to  handle  traffic  seamlessly  as  a  group. 

A  specification  for  copper  cabling  that  allows  up  to  33-meter  distances  between  cabinets. 

Allows  any  unused  bandwidth  in  a  Class  1  connection. 

See  ISL. 

In-order  delivery.  A  parameter  that,  when  set,  guarantees  that  frames  are  either  delivered  in 
order  or  dropped. 

Internet  Protocol.  The  addressing  part  of  TCP. 
Intelligent  Peripheral  Interface. 
iSCSI  qualified  name. 
Internet  Software  Consortium. 

Internet  Small  Computer  Systems  Interface.  A  protocol  that  defines  the  processes  for 
transferring  block  storage  applications  over  TCP/IP  networks  by  encapsulating  SCSI 
commands  into  TCP  and  transporting  them  over  the  network  via  IP. 
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The  HP  multiprotocol  SAN  routing  service  that  maps  the  FCP  protocol  to  the  IP  transport.  This 
service  projects  iSCSI  hosts  onto  the  backbone  fabric  of  a  gateway  sv/itch. 

Intersv/itch  link.  A  Fibre  Channel  link  from  the  E  Port  of  one  switch  to  the  E_Port  of  another.  See 
also  cascade,  E_Port. 

The  ratio  of  the  number  of  free  ports  (non-ISL)  to  the  number  of  ISLs  on  a  switch. 


An  E_Port  that  is  online  but  not  operational  due  to  overlapping  domain  IDs  or  nonidentical 
parameters  (such  as  E_D_TOVs).  See  also  E_Port. 

Internet  service  provider. 

Information  unit.  A  set  of  information  as  defined  by  either  an  upper-level  process  protocol 
definition  or  upper-level  protocol  mapping. 

(Just  a  bunch  of  disks)  Indicates  a  number  of  disks  connected  in  a  single  chassis  to  one  or 
more  controllers.  See  also  RAID. 

A  deviation  in  timing  for  a  bit  stream  as  it  flows  through  a  physical  medium. 

A  special  1 0-bit  character  used  to  indicate  the  beginning  of  a  transmission  word  that  performs 
Fibre  Channel  control  and  signaling  functions.  The  first  seven  bits  of  the  character  are  the 
comma  pattern.  See  a/so  comma. 

A  string  of  data  (usually  a  numeric  value)  shared  between  two  entities  and  used  to  control  a 
cryptographic  algorithm.  Usually  selected  from  a  large  pool  of  possible  keys  to  make 
unauthorized  identification  of  the  key  difficult.  See  also  key  pair. 

In  public  key  cryptography,  a  pair  of  keys  consisting  of  an  entity's  public  and  private  key.  The 
public  key  can  be  publicized,  but  the  private  key  must  be  kept  secret.  See  also  public  key 
cryptography. 

Loop  port.  A  node  port  (NL_Port)  or  fabric  port  (FL_Port)  that  has  arbitrated-loop  capabilities. 
An  L  Port  can  be  in  either  Fabric  Mode  or  Loop  Mode. 

Local  area  network.  A  network  in  which  transmissions  typically  take  place  over  fewer  than  5 
kilometers  (3.4  miles). 

The  time  required  to  transmit  a  frame.  Together,  latency  and  bandwidth  define  the  speed  and 
capacity  of  a  link  or  system. 

Light-emitting  diode.  Used  to  indicate  the  status  of  elements  on  a  switch. 

Loop-initialization  fabric-assigned  frame.  Contains  a  bitmap  of  all  fabric-assigned  AL_PAs  and 
is  the  first  frame  transmitted  in  the  loop  initialization  process  after  a  temporary  loop  master  has 
been  selected. 

Loop-initialization  hard-assigned  frame.  A  hard-assigned  AL_PA  that  is  indicated  by  a  bit  set 
and  is  the  third  frame  transmitted  in  the  loop  initialization  process  after  a  temporary  loop 
master  has  been  selected. 

Loop-initialization  loop-position  frame.  The  final  frame  transmitted  in  a  loop  initialization 
process.  A  returned  LIRP  contains  an  accumulation  of  all  of  the  AL_PA  position  maps.  This 
allows  loop  members  to  determine  their  relative  loop  position.  This  is  an  optional  frame  and  is 
not  transmitted  unless  the  LIRP  is  also  transmitted. 


Link  Services 


A  protocol  for  link-related  actions. 
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LIP 

LlPA 

LIRP 

LISA 

LISM 

LM_TOV 

login  server 
Loom 

loop  circuit 
loop  failure 

LoopJD 

loop  initialization 
Loop  Mode 

looplet 
LPB 

LPE 

LPSM 

LR 
LRR 


Loop  initialization  primitive.  The  signal  used  to  begin  initialization  in  a  loop.  Indicates  either 
loop  failure  or  node  resetting. 

Loop-initialization  previously  assigned.  The  device  marks  a  bit  in  the  bitmap  if  it  did  not  log  in 
with  the  fabric  in  a  previous  loop  initialization. 

Loop-initialization  report  position  frame.  The  first  frame  transmitted  in  the  loop  initialization 
process  after  all  L_Ports  have  selected  an  AL_PA.  The  LIRP  gets  transmitted  around  the  loop  so 
all  L_Ports  can  report  their  relative  physical  position.  This  is  an  optional  frame. 

Loop-initialization  soft-assigned  frame.  The  fourth  frame  transmitted  in  the  loop  initialization 
process  after  a  temporary  loop  master  has  been  selected.  L_Ports  that  have  not  selected  an 
AL_PA  in  a  LIFA,  LlPA,  or  LIMA  frame  select  their  AL_PA  here. 

Loop-initialization  select  master  frame.  The  first  frame  transmitted  in  the  initialization  process 
v/hen  L_Ports  select  an  AL_PA.  LISM  is  used  to  select  a  temporary  loop  master  or  the  L_Port  that 
will  subsequently  start  transmission  of  the  LIFA,  LlPA,  LIMA,  LISA,  LIRF*,  or  LILP  frames. 

Loop  master  timeout  value.  The  minimum  time  that  the  loop  master  waits  for  a  loop 
initialization  sequence  to  return. 

The  unit  that  responds  to  login  requests. 

The  code  name  given  to  the  second-generation  HP  Fabric  ASIC.  This  is  the  ASIC  used  in  the  1 
GB  switches. 

A  temporary  bidirectional  communication  path  established  between  L_Ports. 

Loss  of  signal  within  a  loop  for  any  period  of  time,  or  loss  of  synchronization  for  longer  than 
the  timeout  value. 

A  hexadecimal  value  representing  one  of  the  1  27  possible  AL_PA  values  in  an  arbitrated  loop. 

The  logical  procedure  used  by  an  L_Port  to  discover  its  environment.  Can  be  used  to  assign 
AL_PA  addresses,  detect  loop  failure,  or  reset  a  node. 

One  of  two  possible  modes  for  an  L_Port,  in  which  the  L_Port  is  in  an  arbitrated  loop,  using 
loop  protocol.  An  L_Port  in  Loop  Mode  can  also  be  in  Participating  Mode  or  Nonparticipating 
Mode. 

A  set  of  devices  connected  in  a  loop  to  a  port  that  is  a  member  of  another  loop. 

Loop  port  bypass.  A  primitive  sequence  transmitted  by  an  L_Port  to  bypass  one  or  all  L_Ports  to 
which  it  is  directed.  It  is  used  only  in  arbitrated  loops. 

Loop  port  enable.  A  primitive  sequence  transmitted  by  an  L_Port  to  enable  one  or  all  L_Ports 
that  have  been  bypassed  with  the  LPB.  It  is  used  only  in  arbitrated  loops. 

Loop  Port  State  Machine.  Logic  that  monitors  and  performs  the  tasks  required  for  initialization 
and  access  to  the  loop.  It  is  maintained  by  an  L_Port  to  track  behavior  through  different  phases 
of  loop  operations.  Alternatively,  the  logical  entity  that  performs  arbitrated-loop  protocols  and 
defines  the  behavior  of  L_Ports  when  they  require  access  to  an  arbitrated  loop. 

Link  reset.  A  primitive  sequence  used  during  link  initialization  between  two  N_Ports  in 
point-to-point  topology  or  an  N_Port  and  an  F_Port  in  fabric  topology.  The  expected  response 
is  an  LRR. 

Link  reset  response.  A  primitive  sequence  during  link  initialization  between  two  N_Ports  in 
point-to-point  topology  or  an  N_Port  and  an  F_Port  in  fabric  topology.  It  is  sent  in  response  to 
an  LR  and  expects  a  response  of  Idle. 
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Logical  storage  area  network.  An  LSAN  enables  device  and  storage  connectivity  that  spans 
two  or  more  fabrics.  The  path  between  devices  in  an  LSAN  can  be  local  to  a  fabric  or  cross 
one  or  more  FC  routers  and  one  or  more  backbone  fabrics. 

The  mechanism  by  which  LSANs  are  administered.  An  FC  router  attached  to  two  fabrics  will 
"listen"  for  the  creation  of  matching  LSAN  zones  on  both  fabrics.  If  this  occurs,  it  will  create 
phantom  domains  and  FC-NAT  entries  as  appropriate,  and  insert  entries  for  them  into  the 
name  servers  on  the  fabrics.  LSAN  zones  are  compatible  with  all  standard  zoning 
mechanisms. 

Long  wavelength.  A  type  of  fiber  optic  cabling  that  is  based  on  1 300-mm  lasers  and  supports 
link  speeds  of  1 .0625  Gb/sec.  Can  also  refer  to  the  type  of  GBIC  or  SFP.  See  also  SWL. 

Memory  allocation.  Usually  relates  to  buffer  credits. 

Metropolitan  area  network. 

Megabytes  per  second. 

Megabits  per  second. 

The  collection  of  all  devices,  switches,  edge  and  backbone  fabrics,  LSANs,  and  FC  routers  that 
make  up  a  physically  connected  but  logically  partitioned  storage  network.  LSANs  span 
between  edge  fabrics  using  FC  routers.  In  a  data  network,  this  would  simply  be  called  the 
network.  However,  an  additional  term  is  required  to  specify  the  difference  between  a 
single-fabric  network  (SAN),  a  multifabric  network  without  cross-fabric  connectivity 
(dual-redundant  fabric  SAN),  and  a  multifabric  network  with  connectivity  (meta-SAN). 

A  relative  value  assigned  to  a  route  to  aid  in  calculating  the  shortest  path  (1000  @  1  Gb/s, 
500  @  2  Gb/s). 

Media  interface  adapter.  A  device  that  converts  optical  connections  to  copper  ones,  and 
vice -versa. 

Management  Information  Base.  An  SNMP  structure  to  help  with  device  management, 
providing  configuration  and  device  information. 

Multimode  fiber.  See  SWL. 

Managed  Object  Format  file. 

A  platform  running  the  HP  Fibre  Channel  Routing  Service  or  FC-to-FC  routing  (for  instance,  the 
MP  Router)  that  enables  two  or  more  fabrics  to  share  resources  (such  hosts  or  storage  devices) 
without  merging  those  fabrics.  The  platform  could  simultaneously  be  used  as  an  MP  router 
and  as  an  FCIP  tunnel  or  iSCSI  gateway. 

Mark  primitive  signal.  Used  only  in  arbitrated  loop,  MRK  is  transmitted  by  an  L_Port  for 
synchronization  and  is  vendor  specific. 

Management  Server.  The  Management  Server  allows  a  storage  area  network  (SAN) 
management  application  to  retrieve  information  and  administer  the  fabric  and  interconnected 
elements,  such  as  switches,  servers,  and  storage  devices.  The  MS  is  located  at  the  Fibre 
Channel  well-known  address  FFFFFAh. 

Management  Server  daemon.  Monitors  the  MS.  Includes  the  Fabric  Configuration  Service  and 
the  Unzoned  Name  Server. 

Multiprotocol  SAN  Routing  Services.  An  optionally  licensed  software  bundle  available  on 
certain  HP  platforms,  such  as  the  HP  MP  Router,  that  includes  the  Fibre  Channel  Routing 
Service,  the  iSCSI  Gateway  Service,  and  the  FCIP  Tunneling  Service. 


MTBF 
multicast 

multimode 
N_Port 

Name  Server 

NAS 

NDMP 

NL_Port 

node 

node  count 

node  name 

Nonparticipating 
Mode 

NOS 

NR_Pon 
NS 

NSCAM 

Nx_Pon 
OFC 

OLS 
ON 
OPN 


Mean  time  between  failures.  An  expression  of  time,  indicating  tfie  longevity  of  a  device. 

Tfie  transmission  of  data  from  a  single  source  to  multiple  specified  N_Ports  (as  opposed  to  all 
tfie  ports  on  tfie  network).  See  also  broadcast,  unicast. 

A  fiber  optic  cabling  specification  tfiat  allows  up  to  500  meters  between  devices. 

Node  port.  A  port  on  a  node  that  can  connect  to  a  Fibre  Ctiannel  port  or  to  another  N_Port  in 
a  point-to-point  connection.  See  also  NL_Port,  Nx_Port. 

Simple  Name  Server  (SNS).  A  switch  service  that  stores  names,  addresses,  and  attributes  for 
up  to  15  minutes  and  provides  them  as  required  to  other  devices  in  the  fabric.  SNS  is  defined 
by  Fibre  Channel  standards  and  exists  at  a  well-known  address.  Also  referred  to  as  directory 
service. 

Network-attached  storage.  A  disk  array  connected  to  a  controller  that  gives  access  via  a  LAN. 

Network  Data  Management  Protocol.  Used  for  tape  backup  without  using  server  resources. 

Node  loop  port.  A  node  port  that  has  arbitrated-loop  capabilities.  Used  to  connect  an 
equipment  port  to  the  fabric  in  a  loop  configuration  through  an  FL  Port.  See  also  N  Port, 
Nx_Port. 

A  Fibre  Channel  device  that  contains  an  N  Port  or  NL_Port. 
The  number  of  nodes  attached  to  a  fabric. 

The  unique  identifier  for  a  node,  communicated  during  login  and  port  discovery. 

A  mode  in  which  an  L  Port  in  a  loop  is  inactive  and  cannot  arbitrate  or  send  frames  but  can 
retransmit  received  transmissions.  This  mode  is  entered  if  there  are  more  than  1  27  devices  in  a 
loop  and  an  AL_PA  cannot  be  acquired.  See  also  L_Port,  Participating  Mode. 

Not  operational.  The  NOS  primitive  sequence  is  transmitted  to  indicate  that  the  FC_Port 
transmitting  the  NOS  has  detected  a  link  failure  or  is  offline,  waiting  for  the  offline  sequence 
(OLS)  to  be  received. 

A  normal  E_Port  used  to  connect  an  FC  router  to  a  backbone  fabric. 

Name  Server.  The  service  provided  by  a  fabric  switch  that  stores  names,  addresses,  and 
attributes  related  to  Fibre  Channel  objects.  Can  cache  information  for  up  to  15  minutes.  Also 
known  as  Simple  Name  Server  or  as  a  directory  service.  See  also  Simple  Name  Server  (SNS). 

Name  Server  Cache  Manager.  Updates  the  Name  Server  (NS)  databases  across  switches  as 
a  background  task. 

A  node  port  that  can  operate  as  either  an  N  Port  or  NL  Port. 

Open  fiber  control.  A  method  used  to  enable  and  disable  laser  signaling  for  higher-intensity 
laser  transceivers. 

Primitive  sequence  offline. 

Offline  notification.  Refers  to  an  ELS  field  that  appears  in  portLogDump  command  output. 

Open  primitive  signal.  Applies  only  to  arbitrated  loop;  sent  by  an  L_Port  that  has  won  the 
arbitration  process  to  open  communication  with  one  or  more  ports  on  the  loop. 
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ordered  set 


originator 
out-of-band 

oversub-scription 

OX_ID 
PAL 

parallel 

Participating  Mode 
passive  copper 
path  selection 
payload 

PBC 
PCM 

Performance 
Monitoring 

persistent  error  log 

phantom  address 

phantom  device 

phantom  domain 
PID 


A  transmission  word  that  uses  8b/10b  mapping  and  begins  with  the  K28.5  character. 
Ordered  sets  occur  outside  of  frames  and  include  the  following  items: 

•  Frame  delimiters— Mark  frame  boundaries  and  describe  frame  contents. 

•  Primitive  signals— Indicate  events. 

•  Primitive  sequences— Indicate  or  initiate  port  states. 

Ordered  sets  are  used  to  differentiate  Fibre  Channel  control  information  from  data  frames  and 
to  manage  frame  transport. 

The  Nx_Port  that  originated  an  exchange. 

Transmission  of  management  protocol  outside  of  the  Fibre  Channel  network,  usually  over 
Ethernet. 

A  situation  in  which  more  nodes  could  potentially  contend  for  a  resource  than  the  resource 
could  simultaneously  support  (typically  an  ISL).  Oversubscription  could  be  a  desirable  attribute 
in  fabric  topology,  as  long  as  it  does  not  produce  unacceptable  levels  of  congestion. 

Originator  ID  or  exchange  ID.  Refers  to  the  exchange  ID  assigned  by  the  originator  port. 

Programmable  Array  Logic.  A  relatively  small  FPD. 

The  simultaneous  transmission  of  data  bits  over  multiple  lines. 

A  mode  in  which  an  L  Port  in  a  loop  has  a  valid  AL_PA  and  can  arbitrate,  send  frames,  and 
retransmit  received  transmissions.  See  also  L_Port,  Nonparticipating  Mode. 

A  low-cost  copper  Fibre  Channel  connection,  allowing  distances  up  to  13  meters  between 
devices. 

The  selection  of  a  transmission  path  through  the  fabric.  HP  switches  use  the  FSPF  protocol.  See 
also  FSPF. 

A  Fibre  Channel  frame  has  a  header  and  a  payload.  The  payload  contains  the  information 
being  transported  by  the  frame;  it  is  determined  by  the  higher-level  service  or  FC_4  upper-level 
protocol.  There  are  many  different  payload  formats,  based  on  protocol. 

Port  bypass  circuit.  A  circuit  in  hubs  or  a  disk  enclosure  to  open  or  close  a  loop  to  add  or 
remove  nodes. 

Pulse-code  modulation.  A  standard  method  of  encoding  analog  audio  signals  in  digital  form. 

A  HP  switch  feature  that  monitors  port  traffic  and  includes  frame  counters,  SCSI  read 
monitors,  SCSI  write  monitors,  and  other  types  of  monitors. 

Error  messages  of  a  high  enough  level  (by  default.  Panic  or  Critical)  are  saved  to  flash  memory 
on  the  switch  instead  of  to  RAM.  These  messages  are  saved  over  reboots  and  power  cycles, 
constituting  the  persistent  error  log.  Note  that  each  CP  on  a  2/64  has  its  own  unique 
persistent  error  log. 

An  AL  PA  value  that  is  assigned  to  a  device  that  is  not  physically  in  the  loop.  Also  known  as 
phantom  AL_PA. 

A  device  that  is  not  physically  in  an  arbitrated-loop  but  is  logically  included  through  the  use  of 
a  phantom  address. 

See  xiate  domain. 

Port  identifier. 
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PKI 

PKI  certification 
utility 

PLDA 

PLOGI 

point-to-point 
port 

port  address 

port  card 

port  log 

port  log  dump 

port  name 
port  swapping 

portname 

POST 
PPP 

primary  FCS  switch 

primitive  sequence 

primitive  signals 

principal  switch 
private  device 

private  key 


Public  key  infrastructure.  An  infrastructure  that  is  based  on  public  key  cryptography  and  CA 
(certificate  authority)  and  that  uses  digital  certificates.  See  also  CA,  digital  certificate,  public 
key  cryptography. 

Public  key  infrastructure  certification  utility.  A  utility  that  makes  it  possible  to  collect  certificate 
requests  from  switches  and  to  load  certificates  to  switches.  See  also  digital  certificate,  PKI. 

Private  loop  direct-attached.  A  technical  report  specifying  a  logical  loop. 

Port  login.  The  port-to-port  login  process  by  which  initiators  establish  sessions  with  targets.  See 
also  FLOGI. 

A  Fibre  Channel  topology  that  employs  direct  links  between  each  pair  of  communicating 
entities.  See  also  topology. 

In  a  HP  switch  environment,  an  SFP  or  GBIC  receptacle  on  a  switch  to  which  an  optic  cable 
for  another  device  is  attached. 

In  Fibre  Channel  technology,  the  port  address  is  defined  in  hexadecimal.  In  the  HP  Fabric  OS, 
a  port  address  can  be  defined  by  a  domain  and  port  number  combination  or  by  area  number. 
In  an  ESCON  Director,  an  address  used  to  specify  port  connectivity  parameters  and  to  assign 
link  addresses  for  attached  channels  and  control  units. 

A  hardware  component  that  provides  a  platform  for  field-replaceable,  hot  swappable  ports. 
A  record  of  all  activity  on  a  switch,  kept  in  volatile  memory. 

A  view  of  what  happens  on  a  switch,  from  the  switch's  point  of  view.  The  portLogDump 
command  is  used  to  read  the  port  log. 

A  user-defined  alphanumeric  name  for  a  port. 

Port  swapping  is  the  ability  to  redirect  a  failed  port  to  another  port.  This  feature  is  available  in 
Fabric  OS  v4.1 .0  and  higher. 

The  unique  identifier  assigned  to  a  Fibre  Channel  port.  Communicated  during  login  and  port 
discovery. 

Power-on  self-test.  A  series  of  tests  run  by  a  switch  after  it  is  turned  on. 
Point-to-Point  Protocol. 

Relates  to  the  HP  Secure  Fabric  OS  feature.  The  primary  fabric  configuration  server  switch 
actively  manages  security  and  configurations  for  all  switches  in  the  fabric.  See  also  backbone 
fabric,  FCS  switch. 

An  ordered  set  that  is  transmitted  repeatedly  and  continuously.  Primitive  sequences  are 
transmitted  to  indicate  specific  conditions  within  or  conditions  encountered  by  the  receiver 
logic  of  an  FC_Port.  See  OLS  and  NOS. 

An  ordered  set  that  indicates  actions  or  events  and  requires  just  one  occurrence  to  trigger  a 
response.  IDLE  and  R_RDY  are  used  in  all  three  topologies:  ARB,  OPN,  and  CLS.  MRK  is  used 
in  arbitrated  loop. 

The  first  switch  to  boot  up  in  a  fabric.  Ensures  unique  domain  IDs  among  roles. 

A  device  that  supports  arbitrated-loop  protocol  and  can  interpret  8-bit  addresses  but  cannot 
log  in  to  the  fabric. 

The  secret  half  of  a  key  pair.  See  also  key,  key  pair. 
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private  loop 
private  loop  device 

private  NL  Port 

protocol 

pstate 
PSU 

public  device 


public  key 

public  key 
cryptography 


public  loop 

public  NL_Port 

QLA 

QLFA 

QoS 

quad 

queue 

QuickLoop 

QuickLoop  Mode 

R_A_TOV 

R_CTL 
R_RDY 
R  T  TOV 


An  arbitrated  loop  that  does  not  include  a  participating  FL_Port. 

A  device  that  supports  a  loop  and  can  understand  8-bit  addresses  but  does  not  log  in  to  the 
fabric. 

An  NL_Port  that  communicates  only  with  other  private  NL_Ports  in  the  same  loop  and  does  not 
log  in  to  the  fabric. 

A  defined  method  and  set  of  standards  for  communication.  Determines  the  type  of 
error-checking,  the  data-compression  method,  how  sending  devices  indicate  an  end  of 
message,  and  how  receiving  devices  indicate  receipt  of  a  message. 

Port  State  Machine. 

Power  supply  unit. 

A  device  that  supports  arbitrated-loop  protocol,  can  interpret  8-bit  addresses,  and  can  log  in 
to  the  fabric. 

The  public  half  of  a  key  pair.  See  also  key,  key  pair. 

A  type  of  cryptography  that  uses  a  key  pair,  with  the  two  keys  in  the  pair  called  at  different 
points  in  the  algorithm.  The  sender  uses  the  recipient's  public  key  to  encrypt  the  message,  and 
the  recipient  uses  the  recipient's  private  key  to  decrypt  it.  See  also  key  pair,  "PKI". 

An  arbitrated  loop  that  includes  a  participating  FL_Port  and  can  contain  both  public  and 
private  NL  Ports. 

An  NL_Port  that  logs  in  to  the  fabric,  can  function  within  either  a  public  or  a  private  loop,  and 
can  communicate  with  either  private  or  public  NL_Ports. 

A  type  of  Fibre  Channel  controller. 

QuickLoop  Fabric  Assist.  Arbitrated-loop  technology. 

Quality  of  service. 

A  group  of  four  adjacent  ports  that  share  a  common  pool  of  frame  buffers. 

A  mechanism  for  each  AL_PA  address  that  allows  for  collecting  frames  prior  to  sending  them 
to  the  loop. 

A  HP  software  product  that  allows  multiple  ports  on  a  switch  to  create  a  logical  loop.  Devices 
connected  via  QuickLoop  appear  to  each  other  as  if  they  are  on  the  same  arbitrated  loop. 

Allows  initiator  devices  to  communicate  with  private  or  public  devices  that  are  not  in  the  same 
loop. 

Resource  allocation  timeout  value.  The  maximum  time  a  frame  can  be  delayed  in  the  fabric 
and  still  be  delivered.  See  also  E_D_TOV,  RR_TOV. 

Route  control.  The  first  8  bits  of  the  header,  which  defines  the  type  of  frame  and  its  contents. 

Receiver  ready.  A  primitive  signal  indicating  that  the  port  is  ready  to  receive  a  frame. 

Receiver  transmitter  timeout  value,  used  by  receiver  logic  to  detect  loss  of  synchronization 
between  transmitters  and  receivers. 


radius  server 


Remote  access  dial-up  server,  used  to  verify  identity  credentials  in  network  environments.. 
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RAID 

RAIT 
RCS 

RCS_SFC 
receiver 
redundancy 
remote  switch 

repeater 
request  rate 
resilience 

resilient  core/edge 
topology 

responder 

retimer 

return  loss 

RLS 
route 

routing 
RRJOV 

RSCN 


RTWR 

running  disparity 

RW 
RX 

RX  ID 


Redundant  array  of  independent  disks.  A  collection  of  disk  drives  that  appear  as  a  single 
volume  to  the  server  and  are  fault  tolerant  through  mirroring  or  parity  checking.  See  also 
JBOD. 

Redundant  array  of  independent  tapes. 

Reliable  Commit  Service.  Refers  to  HP-specific  ILS  command  code. 
RCS  Stage  Fabric  Config.  Refers  to  HP-specific  ILS  command  code. 
A  device  that  performs  detection  and  signal  processing. 

Having  multiple  occurrences  of  a  component  to  maintain  high  availability  (HA). 

An  optional  product  for  long-distance  fabrics,  requiring  a  Fibre  Channel-to-ATM  or  SONET 
gatev^ay. 

A  circuit  that  uses  a  recovered  clock  to  regenerate  and  transmit  an  outbound  signal. 
The  rate  at  v^hich  requests  arrive  at  a  servicing  entity. 

A  fabric's  ability  to  adapt  to  or  tolerate  a  failure  of  a  component  v/ithin  the  fabric. 

Two  or  more  sv/itches  acting  as  a  core  to  interconnect  multiple  edge  sv/itches.  Nodes  attach  to 
the  edge  sv/itches. 

The  N_Port  with  which  an  exchange  originator  attempts  to  communicate. 

A  circuit  that  uses  an  independent  clock  to  generate  outbound  signals. 

The  ratio  (expressed  in  dB)  of  incident  power  to  reflected  power,  when  a  component  or 
assembly  is  introduced  into  a  link  or  system.  Can  refer  to  optical  power  or  to  electrical  power 
in  a  specified  frequency  range. 

Read  Link  Status. 

As  it  applies  to  a  fabric,  the  communication  path  between  two  switches.  Might  also  apply  to 
the  specific  path  taken  by  an  individual  frame,  from  source  to  destination.  See  also  FSPF. 

The  assignment  of  frames  to  specific  switch  ports,  according  to  frame  destination. 

Resource  recovery  timeout  value.  The  minimum  time  a  target  device  in  a  loop  waits  after  an  LIP 
before  logging  out  an  SCSI  initiator.  See  also  E  D  TOV,  R  A  TOV. 

Registered  state  change  notification.  A  switch  function  that  allows  notification  of  fabric 
changes  to  be  sent  from  the  switch  to  specified  nodes.  The  fabric  controller  issues  RSCN 
requests  to  N  Ports  and  NL  Ports,  but  only  if  they  have  registered  to  be  notified  of  state 
changes  in  other  N  Ports  and  NL  Ports.  This  registration  is  performed  via  the  State  Change 
Registration  (SCR)  Extended  Link  Service.  An  N  Port  or  NL  Port  can  issue  an  RSCN  to  the 
fabric  controller  without  having  completed  SCR  with  the  fabric  controller. 

Reliable  transport  with  response.  Might  appear  as  a  task  in  portLogDump  command  output. 

A  binary  parameter  indicating  the  cumulative  disparity  (positive  or  negative)  of  all  previously 
issued  transmission  characters. 

Read/write.  Refers  to  access  rights. 

Receiving  frames. 

Responder  exchange  identifier.  A  2-byte  field  in  the  frame  header  that  can  be  used  by  the 
responder  of  the  exchange  to  identify  frames  as  being  part  of  a  particular  exchange. 
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S_ID 
SAN 

SAN  architecture 

SAN  port  count 
scalability 

sec 


SCN 

SCSI 

SCSI-2 
SCSI-3 
SDRAM 
sectelnet 
Secure  Fabric  OS 
security  policy 

SEQJD 

sequence 
sequence  initiator 
sequence  recipient 

serial 
server 
service  rate 
SES 

SFF 
SFP 

SFP  cable 


Source  ID.  Refers  to  the  native  port  address  (24  bit  address). 

Storage  area  network.  A  network  of  systems  and  storage  devices  that  communicate  using  Fibre 
Channel  protocols.  See  also  fabric. 

The  overall  design  of  a  storage  network  solution,  which  includes  one  or  more  related  fabrics, 
each  of  which  has  a  topology. 

The  number  of  ports  available  for  connection  by  nodes  in  the  entire  SAN. 

One  of  the  properties  of  a  SAN:  the  size  to  which  a  SAN  topology  can  grow  port  and  switch 
counts  with  ease. 

SC  connector.  An  SC  connector  is  a  fiber-optic  cable  connector  that  uses  a  push-pull  latching 
mechanism  similar  to  common  audio  and  video  cables.  For  bidirectional  transmissions,  two 
fiber  cables  and  two  SC  connectors  (dual  SC)  are  generally  used.  SC  is  specified  by  the  TIA 
as  FOCIS-3. 

State  change  notification.  Used  for  internal  state  change  notifications,  not  external  changes. 
This  is  the  switch  logging  that  the  port  is  online  or  is  an  Fx_Port,  not  what  is  sent  from  the 
switch  to  the  Nx  Ports. 

Small  Computer  Systems  Interface.  A  parallel  bus  architecture  and  a  protocol  for  transmitting 
large  data  blocks  to  a  distance  of  15  to  25  meters. 

An  updated  version  of  the  SCSI  bus  architecture. 

An  SCSI  standard  that  defines  transmission  of  SCSI  protocol  data  over  different  kinds  of  links. 
The  main  memory  for  a  switch. 

A  protocol  similar  to  telnet  but  with  encrypted  passwords  for  increased  security. 

An  optionally  licensed  HP  feature  that  provides  advanced,  centralized  security  for  a  fabric. 

Rules  that  determine  how  security  is  implemented  in  a  fabric.  Security  policies  can  be 
customized  through  HP  Secure  Fabric  OS  or  HP  Fabric  Manager. 

Sequence  identifier.  A  1-byte  field  in  the  frame  header  change  to  identify  the  frames  as  being 
part  of  a  particular  exchange  sequence  between  a  pair  of  ports. 

A  group  of  related  frames  transmitted  in  the  same  direction  between  two  N  Ports. 

The  N  Port  that  begins  a  new  sequence  and  transmits  frames  to  another  N  Port. 

Serializing/deserializing  circuitry.  A  circuit  that  converts  a  serial  bit  stream  into  parallel 
characters,  and  vice-versa. 

The  transmission  of  data  bits  in  sequential  order  over  a  single  line. 

A  computer  that  processes  end-user  applications  or  requests. 

The  rate  at  which  an  entity  can  service  requests.  See  also  request  rate. 

SCSI  Enclosure  Services.  A  subset  of  the  SCSI  protocol  used  to  monitor  temperature,  power, 
and  fan  status  for  enclosed  devices. 

Small-form-factor.  An  industry  term  for  a  smaller  transceiver.  See  SFP. 

Small-form-factor  pluggable.  A  transceiver  used  on  2  GB/sec  switches  that  replaces  the  GBIC. 
A  cable  specifically  designed  for  use  with  an  SFP.  Not  compatible  with  GBICs. 
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SI 


Sequence  initiative. 


Simple  Name  Server 
(SNS) 


Single  CP  Mode 

Single  Mode 
S-Link  Service 

SLP 
SMDS 

SMF 
SMI 

SMI 
SMI-S 
SNA/SDLC 
SNMP 


SNS 
SOF 

soft  zone 


SolP 
SONET 

special  character 


A  switch  service  that  stores  names,  addresses,  and  attributes  for  up  to  15  minutes  and 
provides  them  as  required  to  other  devices  in  the  fabric.  SNS  is  defined  by  Fibre  Channel 
standards  and  exists  at  a  well-known  address.  Also  referred  to  as  directory  service  or  name 
server 

The  -s  option  of  the  f  irmwareDownload  command.  Using  f  irmwareDownload  -s 
enables  Single  CP  Mode.  In  the  2/64,  Single  CP  Mode  enables  a  user  to  upgrade  a  single 
CP  and  to  select  full  install,  autoreboot,  and  autocommit. 

The  fiber-optic  cabling  standard  for  devices  up  to  1 0  km  apart. 

Facilities  used  between  an  N  Port  and  the  fabric,  or  between  two  N_Ports,  for  login, 
sequence/exchange  management,  and  maintaining  connections. 

Service  Location  Protocol. 

Switched  Multimegabit  Data  Service.  A  good  protocol  for  interconnecting  LANs;  however, 
SMDS  has  less  error-checking  capability  than  Frame  Relay. 


Single-mode  fiber.  See  LWL. 

Storage  Management  Initiative.  A  broad-based  initiative  sponsored  by  the  Storage 
Networking  Industry  Association  (SNIA)  to  standardize  all  aspects  of  storage  management  for 
multivendor  storage  networking  products. 

Structure  of  management  information.  A  notation  for  setting  or  retrieving  SNMP  management 
variables. 

Storage  Management  Initiative  Specification.  Defines  the  interface  that  allows  storage 
management  systems  to  manage  and  monitor  storage  area  network  (SAN)  resources. 

Systems  Network  Architecture/Synchronous  Data  Link  Control.  A  structure  for  transferring  data 
among  a  variety  of  computing  platforms. 

Simple  Network  Management  Protocol.  An  Internet  management  protocol  that  uses  either  IP 
for  network-level  functions  and  UDP  for  transport-level  functions,  or  TCP/IP  for  both.  Can  be 
made  available  over  other  protocols,  such  as  UDP/IP,  because  it  does  not  rely  on  the 
underlying  communication  protocols.  See  also  community  (SNMP). 

Simple  Name  Server. 

Start  of  frame.  A  group  of  ordered  sets  that  marks  the  beginning  of  a  frame  and  indicates  the 
class  of  service  the  frame  will  use. 

A  zone  consisting  of  zone  members  that  are  made  visible  to  each  other  through  client  service 
requests.  Typically,  soft  zones  contain  zone  members  that  are  visible  to  devices  using  Name 
Server  exposure  of  zone  members.  The  fabric  does  not  enforce  a  soft  zone.  Note  that 
well-known  addresses  are  implicitly  included  in  every  zone. 

SCSI-over-IP. 

Synchronous  optical  network.  A  standard  for  optical  networks  that  provides  building  blocks 
and  flexible  payload  mappings. 

A  10-bit  character  that  does  not  have  a  corresponding  8-bit  value  but  is  still  considered  valid. 
The  special  character  is  used  to  indicate  that  a  particular  transmission  word  is  an  ordered  set. 
This  is  the  only  type  of  character  to  have  five  1  s  or  Os  in  a  row. 


SPLD 


Simple  PLD.  Usually,  either  a  PLA  or  PAL. 
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SPOF 
SSH 

Standard  Translative 
Mode 

stealth  mode 
striping 

switch 

switch  name 

switch  port 

switch-to-switch 
authentication 

SWL 

syslog 
T10 
Til 

tachyon 
target 
TC 

TCP/IP 
telnet 

tenancy 

throughput 

tiering 

Time  Server 
topology 


Single  point  of  failure.  Any  component  in  a  SAN  whose  malfunction  could  bring  down  the 
entire  SAN. 

Secure  shell.  Used  starting  in  HP  Fabric  OS  v4.1  to  support  encrypted  telnet  sessions  to  the 
switch.  SSH  encrypts  all  messages,  including  the  client  sending  the  password  at  login. 

Allows  public  devices  to  communicate  with  private  devices  that  are  directly  connected  to  the 
fabric. 

A  method  used  in  some  switches  to  simulate  HP  switches  using  QuickLoop. 

A  RAID  technique  for  writing  a  file  to  multiple  disks  on  a  block-by-block  basis,  with  or  without 
parity. 

A  fabric  device  providing  bandwidth  and  high-speed  routing  of  data  via  link-level  addressing. 
The  arbitrary  name  assigned  to  a  switch. 

A  port  on  a  switch.  Switch  ports  can  be  E_Ports,  F_Ports,  or  FL_Ports. 

The  process  of  authenticating  both  switches  in  a  switch-to-switch  connection  using  digital 
certificates.  See  also  authentication,  digital  certificate. 

Short  wavelength.  A  type  of  fiber  optic  cabling  that  is  based  on  850  mm  lasers  and  supports 
1 .0625  GB/sec.  link  speeds.  Can  also  refer  to  the  type  of  GBIC  or  SFP.  See  also  LWL. 

Syslog  daemon.  Used  to  forward  error  messages. 

A  standards  committee  chartered  with  creating  standards  for  SCSI. 

A  standards  committee  chartered  with  creating  standards  for  Fibre  Channel. 

A  chip  that  supports  FC-0  through  FC-2  on  a  single  chip. 

A  storage  device  on  a  Fibre  Channel  network.  See  also  initiator. 

Track  changes. 

Transmission  Control  Protocol  Internet  Protocol. 

A  virtual  terminal  emulation  used  with  TCP/IP.  "Telnet"  is  sometimes  used  as  a  synonym  for  the 
HP  Fabric  OS  CLI. 

The  time  from  when  a  port  wins  arbitration  in  a  loop  until  the  same  port  returns  to  the 
monitoring  state.  Also  referred  to  as  "loop  tenancy." 

The  rate  of  data  flow  achieved  within  a  cable,  link,  or  system.  Usually  measured  in  bps  (bits 
per  second  or  b/sec).  See  also  BB  fabric. 

The  process  of  grouping  particular  SAN  devices  by  function  and  then  attaching  these  devices 
to  particular  switches  or  groups  of  switches  based  on  that  function. 

A  Fibre  Channel  service  that  allows  for  the  management  of  all  timers. 

As  it  applies  to  Fibre  Channel  technology,  the  configuration  of  the  Fibre  Channel  network  and 
the  resulting  communication  paths  allowed.  There  are  three  possible  topologies: 

•  Point  to  point— A  direct  link  between  two  communication  ports. 

•  Switched  fabric— Multiple  N_Ports  linked  to  a  switch  by  F_Ports. 

•  Arbitrated  loop— Multiple  NL_Ports  connected  in  a  loop. 
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TPC 

track  changes 

transceiver 

translate  domain 

Translative  Mode 

transmission 
character 

transmission  word 

trap  (SNMP) 

trunking 

trunking  group 
trunking  ports 
TS 
TTL 

tunneling 
TX 

U_Port 

UDP 
ULP 

ULPJOV 

unicast 

UTC 

WAN 

WANJOV 
watchdog 


Third-party  copy.  A  protocol  for  performing  tape  backups  without  using  server  resources. 

A  HP  Fabric  OS  feature  that  can  be  enabled  to  report  specific  activities  (for  example,  logins, 
logouts,  and  configuration  task  changes).  The  output  from  the  track-changes  feature  is  dumped 
to  the  error  log  for  the  switch. 

A  device  that  converts  one  form  of  signaling  to  another  for  transmission  and  reception;  in  fiber 
optics,  optical  to  electrical. 

See  xiate  domain. 

A  mode  in  which  private  devices  can  communicate  with  public  devices  across  the  fabric. 
A  10-bit  character  encoded  according  to  the  rules  of  the  8b/ 10b  algorithm. 

A  group  of  four  transmission  characters. 

The  message  sent  by  an  SNMP  agent  to  inform  the  SNMP  management  station  of  a  critical 
error.  See  also  SNMP. 

In  Fibre  Channel  technology,  a  feature  that  enables  distribution  of  traffic  over  the  combined 
bandwidth  of  up  to  four  ISLs  between  adjacent  switches,  while  preserving  in-order  delivery. 

A  set  of  up  to  four  trunked  ISLs. 

The  ports  in  a  set  of  trunked  ISLs. 

Time  Server. 

Time-to-live.  The  number  of  seconds  an  entry  exists  in  cache  before  it  expires. 

A  technique  for  enabling  two  networks  to  communicate  when  the  source  and  destination  hosts 
are  both  on  the  same  type  of  network  but  are  connected  by  a  different  type  of  network. 

Transmit. 

Universal  port.  A  switch  port  that  can  operate  as  a  G_Port,  E  Port,  F  Port,  or  FL  Port.  A  port  is 
defined  as  a  U_Port  when  it  is  not  connected  or  has  not  yet  assumed  a  specific  function  in  the 
fabric. 

User  Datagram  Protocol.  A  protocol  that  runs  on  top  of  IP  and  provides  port  multiplexing  for 
upper-level  protocols. 

Upper-level  protocol.  The  protocol  that  runs  on  top  of  Fibre  Channel.  Typical  upper-level 
protocols  are  SCSI,  IP,  HIPPI,  and  IPI. 

Upper-level  timeout  value.  The  minimum  time  that  an  SCSI  ULP  process  waits  for  SCSI  status 
before  initiating  ULP  recovery. 

The  transmission  of  data  from  a  single  source  to  a  single  destination.  See  also  broadcast, 
multicast. 

Universal  Time  Conversion.  Also  known  as  Coordinated  Universal  Time,  which  is  an 
international  standard  of  time.  UTC  is  8  hours  behind  Pacific  Standard  Time  and  5  hours 
behind  Eastern  Standard  Time.  See  also  GMT. 

Wide  area  network. 

Wide  area  network  timeout  value. 

A  software  daemon  that  monitors  Fabric  OS  modules  on  the  kernel. 
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WBEM 
WDM 


[need  definition;  BOFMS] 

Wavelength  division  multiplexer.  Allows  multiple  wavelengths  to  be  combined  or  filtered  on  a 
single  cable. 


well-known  address  As  it  pertains  to  Fibre  Channel  technology,  a  logical  address  defined  by  Fibre  Channel 
standards  as  assigned  to  a  specific  function  and  stored  on  the  switch. 

workstation  A  computer  used  to  access  and  manage  the  fabric.  Also  referred  to  as  a  "management 

station"  or  "host." 

WTV  Write  timeout  value.  Refers  to  an  ELS  field  that  appears  in  portLogDump  command  output. 

WWN  World  Wide  Name.  An  identifier  that  is  unique  worldwide.  Each  entity  in  a  fabric  has  a 

separate  WWN. 

X.25  A  protocol  that  uses  logical  channels.  X.25  allows  high-quality  communications  between 

computers  and  can  accommodate  noisy  data  communications  through  error-detection  and 
-correction  (retransmission)  algorithms. 

xiate  domain  Translate  domain.  A  router  virtual  domain  that  represents  an  entire  fabric.  Device  connectivity 

can  be  achieved  from  one  fabric  to  another,  over  the  router  and  through  this  virtual  domain, 
without  merging  the  two  fabrics.  Also  known  as  phantom  domains. 

zone  A  set  of  devices  and  hosts  attached  to  the  same  fabric  and  configured  as  being  in  the  same 

zone.  Devices  and  hosts  within  the  same  zone  have  access  to  others  in  the  zone  but  are  not 
visible  to  any  outside  the  zone. 

zone  configuration    A  specified  set  of  zones.  Enabling  a  configuration  enables  all  zones  in  that  configuration.  See 
also  defined  zone  configuration,  enabled  zone  configuration. 


zoning 


A  feature  in  fabric  switches  or  hubs  that  allows  segmentation  of  a  node  by  physical  port, 
name,  or  address. 
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Index 


A 

AAA  services  22 
aaaConfig 

AAA  services 

RADIUS 
access  levels  1 7,  1 9 

admin  1  9 

factory  1 9 

root  1  9 

user  1 9 
Advanced  Zoning  license 

Advanced  Zoning  commands  735 

aliAdd  34 

aliCreate  41 

aliDelete  43 

aliRemove  44 

aliShov/  46 

cfgActvShow  78 

cfgAdd  79 

cfgClear  81 

cfgCreate  82 

cfgDelete  84 

cfgDisable  85 

cfgEnable  86 

cfgRemove  87 

cfgSave  89 

cfgShov/  91 

cfgSize  93 

cfgTransAbort  94 

cfgTransShov/  95 

qloopAdd  506 

qloopCreate  507 

qloopDelete  509 

qloopRemove  5 1 0 

qloopShov/  5 1 2 

zoneAdd  718 

zoneCreate  71  9 

zoneDelete  721 

zoneHelp  722 

zoneObjectCopy  724 

zoneObjectExpunge  726 

zoneObjectRename  728 

zoneRemove  730 

zoneShov/  732 
agtCfg Default  24 
agtCfgSet  28 
agtCfgShow  3 1 

SNMP 
aliAdd  34 

Advanced  Zoning  license 

exclusive  primary  PCS  commands 


zoning 
aliasDelete  36 
aliasjoin  37 
aliasPurge  39 
aliasShow  40 
aliCreate  41 

Advanced  Zoning  license 

exclusive  primary  PCS  commands 

zoning 
aliDelete  43 

Advanced  Zoning  license 

exclusive  primary  PCS  commands 

zoning 
aliRemove  44 

Advanced  Zoning  license 

exclusive  primary  PCS  commands 

zoning 
aliShov/  46 

Advanced  Zoning  license 

exclusive  primary  PCS  commands 

zoning 
aptPolicy  48 

arbitrated  loop  parameters 

configuration  1 23 
audience  1  3 
authentication 

configuration  51 
authorized  reseller,  HP  15 
authUtil  51 

B 

backplaneTest  53 
backport  55 
bannerSet  58 
bannerShov/  59 
bcastShov/  60 
bladeBeacon  62 
bladeDisable  63 
bladeEnable  65 
burninErrClear  67 
burninErrShov/  68 
burninLevel  69 
burninStatus  70 

c 

camTest  71 

centralMemoryTest  73 
cfgActvShov/  78 

Advanced  Zoning  license 

zoning 
cfgAdd  79 
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Advanced  Zoning  license 

zoning 
cfgClear  81 

Advanced  Zoning  license 

zoning 
cfgCreate  82 

Advanced  Zoning  license 

exclusive  primary  FCS  commands 

zoning 
cfgDelete  84 

Advanced  Zoning  license 

exclusive  primary  FCS  commands 

zoning 
cfgDisable  85 

Advanced  Zoning  license 

exclusive  primary  FCS  commands 

zoning 
cfgEnable  86 

Advanced  Zoning  license 

exclusive  primary  FCS  commands 

zoning 
cfgRemove  87 

Advanced  Zoning  license 

exclusive  primary  FCS  commands 

zoning 
cfgSave  89 

Advanced  Zoning  license 

exclusive  primary  FCS  commands 

zoning 
cfgShow  91 

Advanced  Zoning  license 

zoning 
cfgSize  93 

Advanced  Zoning  license 

zoning 
cfgTransAbort  94 

Advanced  Zoning  license 

exclusive  primary  FCS  commands 

zoning 
cfgTransShov/  95 

Advanced  Zoning  license 

exclusive  primary  FCS  commands 

zoning 
chassisConfig  97 

public  key  infrastructure 
chassisName  1  00 
chassisShov/  1  01 
chipRegShov/  1 04 
cmemRetentionTest  105 
cmiTest  1 07 

command  and  fabric  OS  versions  745 
configDefault  1  09 

SNMP 
configDov/nload  1 1 1 
configShov/  1  1 4 
configUpload  1 1 6 

SNMP 
configuration 

arbitrated  loop  parameters  123 


authentication  51 
fabric  parameters  1  25 
NS  operation  parameters  1  23 
portlog  events  enable  1  25 
RSCN  transmission  mode  123 
system  services  1  24 
virtual  channel  settings  122 
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